Menu

Sign In Create Free Account
Docs SEO NEO Version 1.x Installation

Installation

Step-by-step install: requirements, copying the module folder, installing in the PW admin, adding the SEO tab to templates, basic configuration, and ProCache compatibility notes.

Requirements

  • ProcessWire 3.0.200 or later
  • PHP 8.1 or later

Step 1 — Download

Download SEO NEO from www.peterknight.digital/downloads/. The download is a ZIP containing the SeoNeo folder.

Step 2 — Copy the module folder

Unzip the download and copy the SeoNeo folder into your site's site/modules/ directory. The result should be:

site/modules/SeoNeo/SeoNeo.module.php
site/modules/SeoNeo/InputfieldSeoNeoPreview.module.php
…

Step 3 — Install in the PW admin

Go to Modules > Refresh in the ProcessWire admin. SEO NEO will appear in the list. Click Install next to it.

On install, the module auto-creates these fields:

  • seoneo_tab — the SEO tab field group wrapper
  • seoneo_preview — display-only Google SERP Preview widget
  • seoneo_title, seoneo_description, seoneo_canonical, seoneo_keywords
  • seoneo_og_image, seoneo_og_type
  • seoneo_custom — per-page custom HTML for <head>
  • seoneo_noindex / seoneo_nofollow — per-page robots checkboxes
  • seoneo_tab_END — closes the SEO tab fieldset

None of these are added to any template automatically — that is the next step.

Step 4 — Add the SEO tab to your templates

Go to Setup > Templates, open any template you want to manage SEO for, switch to the Fields tab, and add seoneo_tab. From version 1.1.0, SEO NEO auto-inserts the remaining SEO fields in canonical order when you save the template.

Repeat for each template whose pages need a SEO tab. Typical targets: blog posts, product pages, landing pages, section index pages, and the homepage.

Step 5 — Configure the basics

Go to Modules > Configure > SeoNeo and set at minimum:

  • Site name — appended to every page title (e.g. "Peter Knight Digital")
  • Auto-inject — leave enabled so SEO NEO inserts the meta block automatically

See Configuration for the full reference.

Step 6 — Running alongside MarkupSEO or Seo Maestro

If you are migrating from another SEO module, you can run both during the transition. Keep both fieldsets in the editor for data entry, but disable auto-inject on whichever module is not yet authoritative for frontend output to avoid doubled meta tags.

SEO NEO's tab defaults to SEO with an optional NEO badge to distinguish it from MarkupSEO's tab. See Migrating from MarkupSEO or Seo Maestro for the full workflow.

Step 7 — Verify

Open any page on a template with seoneo_tab added. You should see an SEO tab (with a NEO badge if enabled) in the page editor. View the page in your browser and check the source for the <!-- SeoNeo --> block inside <head>.

ProCache compatibility

SEO NEO and ProCache coexist without configuration:

  • Cache miss — SEO NEO's hook runs before ProCache stores the result, so the meta block is baked into cached HTML.
  • Cache hit — the cached file already contains the SEO NEO block.
  • After a SEO field edit — PW's standard cache-invalidation rules apply.

ProCache's HTML minifier may strip the <!-- SeoNeo --> comment markers. This is cosmetic only; the actual <meta> tags are preserved.

See also

Last updated