Skip to main content

🧩 SearchAtlas SEO Plugin: Step-by-Step Guide

A Comprehensive Guide to Installing, Using, and Extending the SearchAtlas SEO Plugin for WordPress.

Camilo Aponte avatar
Written by Camilo Aponte
Updated this week

When SEO, support, and development teams talk about Shopify, WordPress, and site infrastructure, conversations often stay isolated. But bridging the technical setup with actionable insights shouldn't be complicated. The SearchAtlas SEO WordPress plugin was designed to harmonize tasks like OTTO Pixel installation, automatic SEO diagnostics, and real-time optimization—all from a friendly, centralized interface.

This guide is your complete manual: from installation and activation to extension, debugging, and monitoring in production. Whether you’re a merchant, agency manager, or developer, you’ll find step‑by‑step instructions here to install, configure, and maximize this tool.

🧭 1. Getting Started

Install the Plugin

  • Search for Search Atlas SEO (or ā€œmetasyncā€) in WordPress Dashboard → Plugins → Add New → Install and Activate

  • Or upload the entire metasync folder into /wp-content/plugins/ and activate from the Plugins page

Dependencies

  • PHP version ≄ 7.1

  • WordPress 5.8+ compatible

  • Requires a valid SearchAtlas API key to connect

Quickstart Setup

  • In WP Admin sidebar, click SearchAtlas

  • Paste your API key (copied from Search Atlas Dashboard → Settings → API Keys)

  • Enable OTTO, save, and confirm activation

  • You can now publish AI‑generated content, run bulk meta updates, and view SearchAtlas SEO metrics directly inside WordPress

šŸ—ļø 2. Architecture Overview

Overview Diagram: Envision a flow where:

  • OTTO Pixel and WP plugin sync site data

  • Plugin triggers API calls to SearchAtlas backend

  • AI content and meta updates can push back into WordPress

Core Components:

  • Main plugin in /wp-content/plugins/metasync/

  • Hooks into WP via init, admin_menu, and rest_api_init

  • Stores settings in WP options table

  • Calls SearchAtlas API endpoints for metadata, audits, redirects

Data Flow:

  1. Site data → WordPress via API key

  2. Plugin sends audit and meta requests

  3. OTTO automation suggestion → plugin writes updates to WP database

  4. User sees changes live in WordPress, synced back to Search Atlas dashboard

(Note: Database schema is minimal—key value pairs related to settings and logs.)

🧪 3. API & Shortcodes (WIP)

  1. REST endpoints: sync project data, push keywords, retrieve audit reports

  2. Shortcodes: display plugin status

  3. WP‑CLI commands for bulk operations (e.g., wp searchatlas sync)

šŸ”„ 4. Development & Contribution

Local Setup

  • Recommended: Docker or Local by Flywheel

  • PHP >= 7.1, WP v5.8+

  • Clone repo, run composer install

Code Standards

  • PSR‑12 compliance, WordPress Coding Standards

Build Tools

  • Uses Composer for dependencies; optionally Gulp/Webpack for JS/CSS if the plugin expands

How to Contribute

  • Fork repo

  • Create a feature branch

  • Submit a Pull Request with detailed testing notes

🧪 5. Testing

  • Unit tests via PHPUnit

  • Integration tests for plugin sync

  • CI/CD using GitHub Actions for code quality and regression checking

🧩 6. Extending the Plugin

Best practices:

  • Use provided hooks (searchatlas_meta_update, etc.) to hook additional behavior

  • Add new settings via WordPress Settings API

  • Contribute UI enhancements via shortcodes or admin pages

šŸ› ļø 7. Troubleshooting & Common Issues

  1. Plugin shows as active but meta updates don’t appear on site
    → Flush cache, deactivate other SEO plugins, and rerun sync

  2. Caching plugins conflict—disable or exclude SearchAtlas scripts

  3. Old legacy OTTO scripts may still be active
    → Disable them via Snippets plugin or custom code

šŸ“„ 8. Change Log

Maintain version history including:

  • Plugin version

  • Added/removed features

  • Deprecated methods

šŸ§‘ā€šŸ’¼ 9. Business‑Level Documentation

User Personas:

  • Marketer: Needs fast AI metadata updates across pages

  • Developer: Integrates the plugin into the agency workflow

  • Site admin: Monitors site health/error logs

Value Proposition:


SearchAtlas SEO plugin automates meta updates, integrates with OTTO, turns technical SEO into managed workflows—all inside WordPress with minimal friction.

🧠 10. Planning & Roadmap Highlights

āœ… Implement OTTO Server-Side Rendering (SSR) logging
āœ… Add cache‑clear button in plugin UI
āœ… Enable reverse-sync metadata editing between WP and OTTO
āœ… Build stats and error dashboard inside WP plugin

Mastering SearchAtlas SEO Plugin means more than clicking buttons—it means understanding the flow from data sync to AI optimization. With this guide, you have everything needed to install, extend, and consistently maintain the plugin in production. Whether you’re optimizing one site or managing dozens for clients, this plugin brings SearchAtlas intelligence into WordPress without sacrificing performance, security, or control.

Did this answer your question?