WP Manifestindependent plugin directory
manifest / seo / wordpress-simple-seo-plugin

Simple SEO Link Master GitLab

by Digital Element · gitlab.com/delement/wordpress-simple-seo-plugin

★ 0stars
0forks

Install

No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:

wp plugin install https://gitlab.com/delement/wordpress-simple-seo-plugin/-/archive/main/wordpress-simple-seo-plugin-main.zip

Readme

Simple SEO Link Master

A lightweight way to set per-URL SEO meta (Title, Description, Keywords), override H1 for archives, and output catalog text. Works alongside Yoast SEO.

Description

Simple SEO Link Master lets you define SEO fields for specific URLs—no bulky options, no theme edits for meta tags. For each URL you can store:

  • Title – used for social og:title when Yoast is present, and for custom use.
  • Meta Description – output in <head> and used to override Yoast’s description where applicable.
  • Keywords (optional metadata).
  • H1 (for term/archive pages, e.g., WooCommerce categories) – replaces the archive title via the single_term_title filter.
  • Catalog Description (long HTML text) – an optional block you can print under a product list on archive pages.

Under the hood, the plugin creates a small table in your database ({prefix}project_name_seo_link_master) and performs a single lookup by the current request URL. If a match exists, it injects meta in wp_head and applies the H1 override. It also provides helper functions to render the catalog description.

Plays nice with Yoast SEO:

  • Overrides Open Graph title and meta/OG description via Yoast filters when custom values are set.

Key Features

  • Per-URL SEO entries (exact match to the request path).
  • Meta <title> (custom use), Meta Description, Keywords (optional).
  • H1 override for taxonomy archives (e.g., WooCommerce categories).
  • Catalog Description: long HTML block you can output below product grids.
  • Admin UI with AJAX saving and nonce checks; capabilities restricted to manage_options.

Screenshots

  1. Admin panel with the SEO table (URL, Title, Description, Keywords, H1, Catalog Description).
  2. Example WooCommerce category showing replaced H1 and inserted catalog text.

(Add images named screenshot-1.png, screenshot-2.png to /assets/ when ready.)

Installation

  1. Upload the plugin folder to /wp-content/plugins/ or install via Plugins → Add New.
  2. Activate Simple SEO Link Master.
  3. Go to SEO Link Master in the admin menu and add entries for the URLs you want to customize.

Optional (WooCommerce catalog text output)

To display the Catalog Description under your product list (archive pages), add this template tag in an appropriate place of your theme/child theme (e.g., archive-product.php):

<?php if ( function_exists( 'project_name_seo_link_master_catalog_description_html' ) ) {
    echo project_name_seo_link_master_catalog_description_html();
} ?>

(If you prefer action hooks, you can attach the function to a WooCommerce hook like woocommerce_after_shop_loop in your theme.)

Usage

  • In SEO Link Master admin page, add a row with:
    • URL – use the path as seen in the browser (e.g., /shop/category/shoes/).
    • Title
    • Meta Description
    • Keywords (optional)
    • H1 (applies to term/archive pages)
    • Catalog Description (HTML allowed)

The plugin will:

  • Inject meta tags in <head> for exact URL matches.
  • Replace term/archive H1 via single_term_title.
  • Provide project_name_seo_link_master_catalog_description_html() to print the long description.

Note: Matching is exact by request URI. Ensure the stored URL matches the site’s permalink structure (including trailing slashes if used).

Frequently Asked Questions

Does it work with Yoast SEO?
Yes. When custom values exist, the plugin overrides Yoast’s Open Graph title and meta/OG description using Yoast’s public filters.

Will it change single post titles?
No. H1 replacement is applied to taxonomy/archive titles via the single_term_title filter (great for WooCommerce categories). Single post titles aren’t altered.

How do I output the catalog text?
Use:

echo project_name_seo_link_master_catalog_description_html();

Place it where you want the text to appear (e.g., below product loops).

What capabilities are required to manage entries?
Access is restricted to users with the manage_options capability.

Does it support URL patterns or regex?
No. Matching is per exact URL.

Is “Keywords” necessary?
Search engines largely ignore meta keywords; the field is optional and provided for legacy workflows.

Developer Notes

  • Table name: {$wpdb->prefix}project_name_seo_link_master
  • Columns: id, url, title, description, keywords, h1, catalog_description
  • Hooks used:
    • wp_head – outputs meta for matched URLs.
    • single_term_title – replaces archive H1 when a custom H1 exists.
    • wpseo_opengraph_title, wpseo_opengraph_desc, wpseo_metadesc – override Yoast OG/description when set.

Helper functions:

project_name_seo_link_master_get_custom_title(): string
project_name_seo_link_master_get_description(): string
project_name_seo_link_master_get_h1(): string
project_name_seo_link_master_catalog_description_html(): string

Changelog

1.4

  • Initial public release: per-URL Title, Meta Description, Keywords.
  • H1 override for term archives.
  • Catalog Description output helper.
  • Yoast SEO OG/description integration.
  • Admin UI with AJAX save and nonce checks.

Upgrade Notice

1.4

First public release. Review URL entries after activation to ensure exact path matching and desired output on archives.

License

This plugin is licensed under the GPLv2 or later.

Read the full README on GitLab →