Appearance
Action hooks
Link Manager Pro has seven action hooks. Four report link events, one fires after the plugin loads, one after settings are saved, and one asks page caches to purge.
Hook them with add_action(): the four link events, link_manager_pro_booted, link_manager_pro_settings_updated and link_manager_pro_cache_should_purge.
Add the code to your own plugin or a must-use plugin. See Use a hook for priority and argument rules.
Events
Each event passes one array. The event key holds the hook name without the link_manager_pro_ prefix, so link_manager_pro_link_clicked sends event set to link_clicked. All values are plain strings and numbers, never objects.
The same four events feed webhooks and AutomatorWP. See Events, webhooks and AutomatorWP.
A listener that throws an error never breaks the plugin. An event fired again from inside its own listener is skipped, so a listener cannot loop.
link_manager_pro_link_clicked
Runs your code each time a visitor's click on a short link is counted.
When it runs: after a short link redirect adds one to the link's click count. It does not run for rate-limited requests, or for clicks the plugin filters out (bots and blocked IP addresses). It runs whether or not click rows are logged. It also runs when a redirect is served, with the slug of the redirect's hidden link.
Parameters:
$payload(array): the event.event(string):link_clicked.link_id(int): the link ID.slug(string): the link slug.target_url(string): the link's destination URL.click_count(int): the link's click count after this click.country_code(string): the visitor's country code, or an empty string when unknown.referrer_domain(string): the referrer host in lowercase withoutwww., or an empty string.
Source: app/Http/Controllers/RedirectController.php, app/Support/Events.php
Usage:
php
add_action( 'link_manager_pro_link_clicked', 'myprefix_log_click' );
function myprefix_log_click( array $payload ): void {
global $wpdb;
$wpdb->insert(
$wpdb->prefix . 'myprefix_clicks',
array(
'link_id' => $payload['link_id'],
'country' => $payload['country_code'],
'created_at' => current_time( 'mysql', true ),
)
);
}link_manager_pro_link_created
Runs your code when a new short link is created.
When it runs: after the link is saved, including its categories, tags and rules. It does not run for links added by the Pretty Links, BetterLinks and ThirstyAffiliates importers, for links put back by a backup restore, or for the hidden links behind redirects and Link Health fixes.
Parameters:
$payload(array): the event.event(string):link_created.link_id(int): the new link ID.slug(string): the link slug.target_url(string): the destination URL.redirect_type(int): the link's redirect status code:301,302or307.created_by(int): the ID of the user who created the link, or 0 when no user is signed in.
Source: app/Services/LinkService.php, app/Support/Events.php
Usage:
php
add_action( 'link_manager_pro_link_created', 'myprefix_notify_new_link' );
function myprefix_notify_new_link( array $payload ): void {
wp_remote_post(
'https://example.com/notify',
array(
'headers' => array( 'Content-Type' => 'application/json' ),
'body' => wp_json_encode(
array( 'text' => 'New short link: ' . $payload['slug'] . ' to ' . $payload['target_url'] )
),
)
);
}link_manager_pro_broken_link_found
Runs your code when the link checker finds a broken link in your content for the first time.
When it runs: when a broken outbound link is first recorded for a post. It does not run again when the same link in the same post is seen broken again. It does not run for visitor 404 errors.
Parameters:
$payload(array): the event.event(string):broken_link_found.url(string): the broken URL.source_post_id(int): the post that contains the link, or 0.status_code(int): the HTTP status code, or 0 when there is none.health_type(string): alwayscontent.detected_at(string): the detection time in UTC, asY-m-d H:i:s.
Source: app/Services/Monitoring/LinkHealthService.php, app/Support/Events.php
Usage:
php
add_action( 'link_manager_pro_broken_link_found', 'myprefix_mail_broken_link' );
function myprefix_mail_broken_link( array $payload ): void {
wp_mail(
get_option( 'admin_email' ),
'Broken link found',
$payload['url'] . ' (status ' . $payload['status_code'] . ') in post ' . $payload['source_post_id']
);
}link_manager_pro_broken_link_fixed
Runs your code when a broken link is marked fixed or gets a redirect.
When it runs: when an issue changes to Fixed (a status change to anything else does not count), or when a redirect is created for it. It does not run again for an issue that is already fixed.
Parameters:
$payload(array): the event.event(string):broken_link_fixed.url(string): the URL that was broken.source_post_id(int): the post that contained it, or 0.health_type(string):contentortraffic.resolution(string):marked_fixedorredirect_created.
Source: app/Http/Controllers/LinkHealthController.php, app/Support/Events.php
Usage:
php
add_action( 'link_manager_pro_broken_link_fixed', 'myprefix_log_fix' );
function myprefix_log_fix( array $payload ): void {
error_log( 'Fixed ' . $payload['url'] . ' by ' . $payload['resolution'] );
}Lifecycle
link_manager_pro_booted
Runs your code once the plugin has finished loading.
When it runs: while the plugin file loads, after all providers are registered and booted. A callback in a normal plugin that loads later is too late, so register it in a must-use plugin.
Parameters:
$app(LinkManagerPro\Framework\Foundation\Application): the plugin application container.
Source: bootstrap/app.php
Usage:
php
// wp-content/mu-plugins/myprefix-lmp.php
add_action( 'link_manager_pro_booted', 'myprefix_after_boot' );
function myprefix_after_boot( $app ): void {
define( 'MYPREFIX_LMP_READY', true );
}Settings
link_manager_pro_settings_updated
Runs your code after a settings group is saved.
When it runs: after the new values are stored, for every save of a group or of a single setting, including a settings restore from a backup file. It runs even when no value changed.
Parameters:
$group(string): the settings group, such astrackingoradvanced.$new(array): all values of that group after the save, keyed by setting name. Encrypted keys such as the AI API key are masked:lmpro_masked:plus the last 4 characters, and an empty key stays empty. A listener that needs the key reads it withSettings::get( 'ai.api_key' ). Two keys with the same last 4 characters look unchanged in$newand$old.$old(array): all values of that group before the save.
Source: app/Services/Settings/SettingsManager.php
Usage:
php
add_action( 'link_manager_pro_settings_updated', 'myprefix_settings_saved', 10, 3 );
function myprefix_settings_saved( string $group, array $new, array $old ): void {
if ( 'tracking' === $group && ( $new['track_clicks'] ?? '' ) !== ( $old['track_clicks'] ?? '' ) ) {
error_log( 'Click tracking is now ' . $new['track_clicks'] );
}
}Caching
link_manager_pro_cache_should_purge
Asks page caches to clear because link content changed.
When it runs: after redirects are added or changed, after auto-link rules, affiliates or link prefixes change, after a short link address changes and after a bulk import. The plugin's own listener purges the supported cache plugins, unless Clear page cache when links change is off. It purges at most once every 30 seconds, and a trigger inside that window schedules one trailing purge.
Parameters: none.
Source: app/Hooks/Handlers/CachingIntegrationHandler.php, app/Support/LinkAddress.php, app/Services/Redirects/SimpleRedirectService.php, app/Services/Content/AutoLinkService.php
Usage:
php
add_action( 'link_manager_pro_cache_should_purge', 'myprefix_purge_cdn' );
function myprefix_purge_cdn(): void {
wp_remote_post( 'https://example.com/purge-my-cdn', array( 'blocking' => false ) );
}