How terrylinooo/airy-seo works
Project Purpose and Type
• This is an open‐source WordPress plugin whose primary goal is to inject SEO‐related meta tags (general, Facebook OpenGraph, Twitter Card) into a site’s pages and provide an admin UI for configuration.
Break Down the File Structure into Logical Components
• Plugin Bootstrap & Core
• airy‑seo.php (plugin header, WP hook registrations)
• airyseo/Launcher.php (initializes modules & admin classes)
• airyseo/Enums.php (constants/enums used throughout)
• Modules (Feature Plugins)
• airyseo/Modules/MetaTags.php
• airyseo/Modules/FacebookOpenGraph.php
• airyseo/Modules/TwitterCard.php
• Admin UI
• airyseo/Admin/*.php (Activation, Menu, Settings, Metabox, Posts)
• views/admin/… (options pages & metabox templates)
• Assets
• assets/css/style.css
• assets/js/metabox.js
• Views (Front‑end & Admin)
• views/modules/*.php (output for front‑end)
• views/admin/parts/*.php (UI partials)
• Persistence & Integration
• WordPress Core (hooks, options API, postmeta, screens)
• Database (wp_options for settings; wp_postmeta for per‑post SEO overrides)
• Third‐Party/Dependencies
• vendor/ (composer dependencies, if any)
Relationships & Data Flows
• At plugin load: WP calls airy‑seo.php → Launcher registers hooks:
• frontend hooks (wp_head) → modules generate meta tags → views/modules/*.php
• admin_init & admin_menu hooks → Admin classes build menu, register settings → settings pages (views/admin/options/*.php)
• add_meta_boxes hook → Metabox module injects per‑post UI (views/admin/metabox.php)
• Settings saved via WP Options API → Modules read settings when rendering tags
• Uninstall hook (uninstall.php) cleans up options/postmeta
Architectural Patterns & Principles
• Modular design: each SEO feature lives in its own Module class
• MVC‑like separation for Admin: Admin classes (controllers) + views/templates (V) + WP options (model)
• Single responsibility: Launcher, Enums, Activation, Settings, Metabox each have discrete roles
• Use of hooks & filters (inversion of control) to integrate cleanly into WP