================================================================================
CQIP STATIC FRAMEWORK - RELEASE BUNDLE
Version 2.1.0
thecontentframework.com · hdfraser.com
================================================================================

CQIP (Content Quality and Intelligence Policy) is a methodology standard for
structured content. CQIP Static is its platform-agnostic PHP implementation.
This bundle contains everything you need to build a schema-rich, AEO-optimised
static website from scratch.

--------------------------------------------------------------------------------
WHAT IS IN THIS BUNDLE
--------------------------------------------------------------------------------

  /cqip/                    The CQIP Static framework skeleton
    cqip-config.php           Site configuration (edit this first)
    cqip-functions.php        Framework helper functions (do not edit)
    cqip-schema.php           Schema.org JSON-LD generator (do not edit)
    cqip-meta.php             SEO meta engine (do not edit)
    blocks/                   Eight canonical block renderers (do not edit)
    templates/                Four page templates (do not edit)
    assets/css/               Stylesheets
      cqip-blocks.css           Block styles (do not edit)
      site.css                  Your site styles (edit freely)
    assets/js/
      cqip-interactive.js       FAQ accordion and enhancements (do not edit)
    assets/images/
      cqip-icon.png             CQIP Static brand icon
      logo.png                  Replace with your own logo

  /clearwater/              Complete working demo site: Clearwater Security
    index.php                 Home page
    about/index.php           About page (compliance + reviews)
    contact/index.php         Contact page
    services/
      access-control/index.php  Service detail page (with technical specs)
    cqip/                     Self-contained copy of the framework

  README.txt                This file
  cqip-static-tutorial.pdf  Step-by-step build tutorial (also in .docx + .md)

--------------------------------------------------------------------------------
QUICK START (5 MINUTES)
--------------------------------------------------------------------------------

1. Upload everything in /cqip/ to your web server's public root.
   Your server needs PHP 7.4 or higher. No database. No composer.

2. Open cqip/cqip-config.php and fill in the Organisation Identity section:
     CQIP_ORG_NAME     Your business name
     CQIP_SITE_URL     https://yourdomain.com
     CQIP_ORG_EMAIL    your@email.com
     (and the other fields as applicable)

3. Create index.php in your site root. Copy the structure from
   clearwater/index.php and replace the content with your own.

4. Load your site in a browser. You should see your page.

5. Validate your schema at search.google.com/test/rich-results.

--------------------------------------------------------------------------------
THE CLEARWATER DEMO SITE
--------------------------------------------------------------------------------

The /clearwater/ folder is a complete, working demonstration site for
Clearwater Security: a hypothetical access control company in Edinburgh.

It shows:
  - A home page with Hero, Answer First, Stats, Capabilities, Solutions,
    FAQ accordion, and a CTA section
  - A service detail page with Technical specifications and FAQ Iceberg
  - An About page with Compliance certifications and Review cards
  - A Contact page with contact boxes and FAQ

To run the demo:
  - Upload the /clearwater/ folder to your server (or set CQIP_BASE_PATH
    in clearwater/cqip/cqip-config.php if testing in a subfolder)
  - Load clearwater/index.php in a browser
  - All four pages are self-contained. No database required.

The clearwater/cqip/ folder is a self-contained copy of the framework.
This means you can upload the demo alongside an existing site without
any path conflicts.

--------------------------------------------------------------------------------
FILE STRUCTURE FOR YOUR OWN SITE
--------------------------------------------------------------------------------

Every page in a CQIP Static site follows the same pattern:

  your-site/
    index.php                 Home page
    services/
      service-name/
        index.php             Service page
    about/
      index.php               About page
    contact/
      index.php               Contact page
    cqip/                     Framework (one copy, shared by all pages)
      cqip-config.php
      ...

Each page file:
  1. Requires cqip/cqip-config.php
  2. Defines $faqItems (if the page has FAQ content)
  3. Defines $blocks (the page content data)
  4. Sets $meta (title, description, canonical)
  5. Calls ob_start(), outputs HTML, calls ob_get_clean()
  6. Requires cqip/templates/base.php (or a page template)

--------------------------------------------------------------------------------
FAQ KEY NAMES: IMPORTANT
--------------------------------------------------------------------------------

CQIP FAQ items must use 'q' and 'a' as key names.

  CORRECT:  ['q' => 'Your question?', 'a' => 'Your answer.']
  WRONG:    ['question' => '...', 'answer' => '...']

Using 'question' and 'answer' causes the FAQ block to render nothing and
produces null values in FAQPage schema. This is the most common mistake.

Enable CQIP_DEBUG in cqip-config.php during development to catch this
automatically.

--------------------------------------------------------------------------------
SCHEMA OUTPUT
--------------------------------------------------------------------------------

CQIP Static generates schema.org JSON-LD automatically. You never write
schema markup by hand. The output is a single @graph containing:

  - Organization (always present on every page)
  - WebPage (always present on every page)
  - BreadcrumbList (when using a page template with parentLabel set)
  - Service or Product entity (enriched by block content)
  - FAQPage (when the faq block is active)
  - AggregateRating + Review[] (when entity_review block is active)

Validate at:
  search.google.com/test/rich-results     (primary: must pass)
  validator.schema.org                    (schema.org compliance)
  validator.w3.org                        (HTML validity)

--------------------------------------------------------------------------------
PERFORMANCE
--------------------------------------------------------------------------------

What to expect when your site goes live:

  Page speed
  CQIP Static serves flat PHP files. No database queries. No plugin
  overhead. A simple shared hosting environment will serve pages in
  under 100ms to first byte. Google PageSpeed Insights scores of 95+
  are typical on a clean server.

  Schema and rich results
  FAQPage rich results typically appear in Google Search within 1-4 weeks
  of deployment on a new domain. On an established domain, faster.
  Google needs to crawl and re-index the page before rich results show.
  Use IndexNow (via CQIP Site Services) to notify Bing immediately.

  AI citation (AEO)
  Answer First blocks with Speakable schema signal to AI Overview systems
  that your content is citation-ready. AI citation is not guaranteed, but
  structured content with clear entity relationships performs significantly
  better than unstructured HTML in AI retrieval benchmarks.
  Expect improved AI citation rates within 4-8 weeks of deployment.

  SEO comparison
  A page built with CQIP Static:
    - Has server-side schema in <head> before any JavaScript runs
    - Has a single, coherent @graph rather than isolated schema fragments
    - Has Speakable markup for AI Overview targeting
    - Has BreadcrumbList for site structure signals
    - Has no plugin overhead, no database calls, no render-blocking scripts
    - Produces valid, warnings-free Rich Results Test output

  A comparable page built without CQIP:
    - Requires manual schema markup or a separate schema plugin
    - Often outputs isolated schema types without @id cross-referencing
    - Has no Speakable markup by default
    - May have render-blocking scripts from plugins or page builders
    - Requires multiple tools to achieve what CQIP produces in one framework

--------------------------------------------------------------------------------
WHAT CQIP IS (AND IS NOT)
--------------------------------------------------------------------------------

CQIP (Content Quality and Intelligence Policy) is a methodology standard,
not a technology stack. The standard defines eight canonical block types,
a schema output model, and a content quality framework that is consistent
across all platforms.

CQIP implementations:
  - CQIP Static (this bundle): static PHP sites
  - WordPress CQIP             WordPress plugin ecosystem
  - CQIP Builder               visual page builder (exports PHP files)

The platform is the implementation detail. Content structured in CQIP on
a static site and content structured in CQIP on WordPress produce the same
schema output, the same block types, and the same AEO signals.

More information: thecontentframework.com

--------------------------------------------------------------------------------
TERMINOLOGY AND AUTHORSHIP
--------------------------------------------------------------------------------

The following terms, methods, and concepts were coined by H D Fraser and
first published through The Content Framework (thecontentframework.com).
They are used throughout this framework and its documentation.

  CQIP
  Content Quality and Intelligence Policy. A methodology standard for
  structured content. First published 2024 by H D Fraser.

  The Content Framework
  The governing body and methodology behind CQIP. The platform-agnostic
  standard that CQIP implements. First published 2024 by H D Fraser.

  Schema Iceberg
  A structured content method in which more question-and-answer pairs are
  attached to a page in FAQPage schema than are displayed visibly to
  visitors. The visible FAQ is what the reader sees. The iceberg is what
  search and AI crawlers read. First described and implemented 2024 by
  H D Fraser as part of the CQIP framework.

  Answer First
  A content block type and writing convention in which the primary answer
  to a page's central question is delivered before supporting detail,
  methodology, or calls to action. Combined with Speakable schema to
  signal citation readiness to AI Overview systems. First defined 2024
  by H D Fraser as part of the CQIP canonical block specification.

These terms are used here in their original sense. If you reference them
in your own work, attribution to H D Fraser and thecontentframework.com
is appreciated.

For licensing or attribution enquiries: thecontentframework.com

--------------------------------------------------------------------------------
LICENCE AND ATTRIBUTION
--------------------------------------------------------------------------------

CQIP Static is released under a custom attribution licence. Full terms are
in LICENCE.txt.

Summary:

  You may use, modify, and distribute CQIP Static for any purpose, including
  commercially, provided that:

  1. Any public-facing site built with CQIP Static includes a visible footer
     link to https://thecontentframework.com

  2. The default footer line in base.php satisfies this requirement:
     "Built with CQIP Static | thecontentframework.com"
     Restyle it to match your design. Do not remove or hide it.

  3. Framework source file headers identifying CQIP Static and
     The Content Framework are preserved.

  4. LICENCE.txt is included with any redistribution of the framework.

The attribution requirement exists to support continued development of the
CQIP ecosystem. It costs nothing to comply with and helps others discover
the framework.

--------------------------------------------------------------------------------
SUPPORT
--------------------------------------------------------------------------------

Documentation:  thecontentframework.com/docs
Author:         H D Fraser MSc  hdfraser.com

================================================================================
