Skip to content

web-lifter/ultimate-seo-wp

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

27 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Ultimate SEO WordPress

Comprehensive SEO toolkit for WordPress with meta editing, redirects, sitemaps, and more.

Version: 0.1.0 Author: Web Lifter License: MIT Requires WordPress: 5.0+ Requires PHP: 7.4+ Text Domain: ultimate-seo-wordpress

Features

Every feature can be independently enabled or disabled from the main settings page.

Meta Editor

  • Custom meta title and description for posts, pages, custom post types, and taxonomy terms
  • Custom canonical URLs
  • Robots meta control: index/noindex, follow/nofollow, noarchive, nosnippet, noimageindex
  • Live SERP preview while editing
  • Template variables for dynamic meta output (e.g. %%title%%, %%sitename%%)

Open Graph

  • Per-post OG title, description, and image fields
  • Global OG defaults with template variable support
  • Automatic featured image fallback

Twitter Cards

  • Per-post Twitter title, description, and image fields
  • Card type selection (summary, summary_large_image, app, player)
  • Global defaults with template variable support

JSON-LD Schema

  • Per-post custom JSON-LD schema editor
  • Website profile settings for Organization/Person structured data
  • Social profile URLs

Redirect Manager

  • 301, 302, 303, 307, 308, 410, and 451 status codes
  • Regex pattern support
  • Optional query string matching
  • Hit counting and last-hit tracking
  • Stored in a custom database table (wp_useo_redirects)

XML & HTML Sitemaps

  • XML sitemap at /sitemap.xml
  • Optional HTML sitemap at /sitemap.html
  • Configurable post types and taxonomies
  • Exclude specific posts or terms
  • Priority calculation based on comment count
  • Gzip compression support
  • Auto-append sitemap URL to robots.txt

Robots.txt Editor

  • Custom robots.txt content via the admin UI
  • Filters WordPress core robots_txt output
  • Optional automatic sitemap URL injection

Bulk Meta Editor

  • Edit meta title, description, robots, and canonical URL across multiple posts
  • Filter by post type
  • Paginated with 20 posts per page

Website Profile

  • Organization or Person schema type
  • Name, logo, website URL, and social profiles
  • Powers JSON-LD WebSite/Organization schema output

Template Variables

Use these tokens in meta title and description templates. They are replaced dynamically on the frontend.

Token Description
%%title%% Post/page title
%%sitename%% Site name
%%tagline%% Site tagline
%%excerpt%% Post excerpt (auto-generated if empty)
%%category%% First category name
%%categories%% Comma-separated category names
%%tag%% First tag name
%%tags%% Comma-separated tag names
%%author%% Post author display name
%%date%% Post published date
%%modified%% Post last modified date
%%currentyear%% Current year
%%parent_title%% Parent post/page title
%%archive_title%% Archive page title
%%search_query%% Search query string
%%page%% "Page X of Y" for paginated content
%%featured_image%% Featured image URL
%%cf_fieldname%% Custom field value (replace fieldname)
%%wc_price%% WooCommerce product price (if active)
%%wc_sku%% WooCommerce product SKU (if active)

File Structure

ultimate-seo-wp/
├── ultimate-seo-wordpress.php      # Main plugin file
├── README.md
├── includes/
│   ├── class-useo-plugin.php       # Bootstrap, activation, hooks
│   ├── class-useo-meta.php         # Post/term meta box editor
│   ├── class-useo-frontend.php     # Frontend <head> meta output
│   ├── class-useo-redirects.php    # Redirect matching and management
│   ├── class-useo-sitemap.php      # XML/HTML sitemap generation
│   ├── class-useo-robots.php       # Robots.txt filtering
│   └── functions.php               # Helpers and token replacement
├── admin/
│   ├── class-useo-admin.php        # Settings pages and admin UI
│   └── class-useo-bulk.php         # Bulk meta editor
└── assets/
    ├── admin-meta.css              # Meta box styling
    ├── admin-meta.js               # Live SERP preview
    └── admin-settings.css          # Settings page styling

Post Meta Keys

Key Type Description
_useo_title string Custom meta title
_useo_description string Custom meta description
_useo_canonical string Custom canonical URL
_useo_robots string Robots meta value
_useo_og_title string Open Graph title
_useo_og_description string Open Graph description
_useo_og_image string Open Graph image URL
_useo_twitter_title string Twitter Card title
_useo_twitter_description string Twitter Card description
_useo_twitter_image string Twitter Card image URL
_useo_schema_json string Custom JSON-LD schema

Options

Option Key Description
useo_features Feature toggle array
useo_meta_defaults Default title/description/robots templates
useo_og_defaults Default Open Graph values
useo_twitter_defaults Default Twitter Card values
useo_website_profile Organization/person profile data
useo_sitemap_settings Sitemap configuration
useo_robots_txt Custom robots.txt content

Database

The plugin creates one custom table on activation:

wp_useo_redirects

Column Type Description
id BIGINT Primary key
source_url VARCHAR(255) URL pattern to match
target_url VARCHAR(255) Destination URL (nullable for 410/451)
status_code SMALLINT HTTP status code (default 301)
is_regex TINYINT Enable regex matching
match_query TINYINT Include query string in matching
hits BIGINT Number of times redirect was triggered
last_hit DATETIME Timestamp of last redirect
created_at DATETIME Row creation timestamp
updated_at DATETIME Row update timestamp

Hooks

Actions

  • init — Registers sitemap rewrite rules
  • template_redirect — Processes redirects (priority 1) and renders sitemaps
  • plugins_loaded — Initializes all plugin components
  • wp_head — Outputs meta description, robots, canonical, OG, Twitter, and JSON-LD tags

Filters

  • document_title_parts — Overrides the page <title> with custom meta title
  • robots_txt — Injects custom robots.txt content and sitemap URL

Installation

  1. Upload the ultimate-seo-wp folder to /wp-content/plugins/
  2. Activate through the WordPress Plugins screen
  3. Navigate to Ultimate SEO in the admin menu
  4. Enable the features you need and configure defaults

Changelog

0.1.0

  • Initial release
  • Meta editor with SERP preview
  • Open Graph and Twitter Card support
  • JSON-LD schema editor
  • Redirect manager with regex and hit tracking
  • XML and HTML sitemap generation
  • Robots.txt editor
  • Bulk meta editor
  • Template variable system with 40+ tokens
  • Feature toggle system

About

Ultimate SEO WP is a WordPress plugin designed to optimize your site's SEO with automated XML sitemaps, custom hreflang management, and other SEO-related features.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Sponsor this project

 

Contributors