Mai Link Injector

A plugin to automatically link keywords to any url. Settings page requires Mai Theme or ACF Pro.

How it works

If a post has any keywords you set (case-insensitive) it will automatically be linked. If "broccoli" was your keyword, use this sentence as an example:

"Broccoli is my favorite vegetable. My favorite way to eat broccoli is with salt and butter."

Mai Link Injector will dynamically add links to the text, keeping the case as-is:

"Broccoli is my favorite vegetable. My favorite way to eat broccoli is with salt and butter."

Usage

1. Visit Dashboard > Mai Theme > Link Injector (if using Mai Theme) or Dashboard > Settings > Mai Link Injector.
2. Add links and optionally modify settings.
3. That's it!

Programmatic Usage

Programmatically add links via the mai_link_injector_links filter.

/**
 * Adds links to Mai Link Injector.
 *
 * @param array $options
 *
 * @return array
 */
add_filter( 'mai_link_injector', function( $options ) {
    $links = [
        'some keywords' => 'https://bizbudding.com',
        'mai theme'     => 'https://bizbudding.com/mai-theme',
        'maple syrup'   => 'https://sugarmakers.org/',
    ];

    // Optionally use conditional tags to conditionally load links.

    // Add new links.
    $options['links'] = array_merge( $options['links'], $links );

    return $options;
});

Programmatic Usage - Dynamic example

This example automatically gets all of the post categories and uses the category name as the keyword(s) and the category archive url as the url. Any post with a same text as a category name will automatically have a link to that category archive.

/**
 * Conditionally adds category archive links to Mai Link Injector.
 *
 * @param array $options
 *
 * @return array
 */
add_filter( 'mai_link_injector', function( $options ) {
    // Bail if not a single post.
    if ( ! is_singular( 'post' ) ) {
        return $options;
    }

    // Set taxonomy name.
    $taxonomy = 'category';

    // Get all terms.
    $terms = get_terms(
        [
            'taxonomy'   => $taxonomy,
            'hide_empty' => false,
            'fields'     => 'id=>name',
        ]
    );

    // Bail if no terms.
    if ( ! $terms || is_wp_error( $terms ) ) {
        return $options;
    }

    // Create array of keywords => links.
    $links = [];

    foreach ( $terms as $term_id => $term_name ) {
        $links[ $term_name ] = get_term_link( $term_id, $taxonomy );
    }

    // Bail if no links.
    if ( ! $links ) {
        return $options;
    }

    $options['singles'][] = 'post'; // Make sure posts are set to inject links.
    $options['singles']   = array_unique( $options['singles'] ); // Remove duplicates.
    $options['links']     = array_merge( $options['links'], $links ); // Adds new links.

    return $options;
});

Limiting elements

Text within the following elements will not have links created:

h1
h2
h3
h4
h5
h6
a
blockquote
button
input
select
submit
textarea

Elements with a mai-link-exclude class will ignore keyword matches.

If you'd like to add or remove these elements, the following filter is available:

$invalid = apply_filters( 'mai_link_injector_invalid_elements', $invalid );