Twoia Intelligence Readme - Source Excerpt 02 - Allowed And Disallowed Material

Summary

This source excerpt begins near Allowed And Disallowed Material and preserves the surrounding evidence from 2IA.org/wp-content/themes/twoia-intelligence/README.md.

**Source path:** 2IA.org/wp-content/themes/twoia-intelligence/README.md

Avoid sensational certainty, fearbait, conspiracy framing, extremist aesthetics, real-person targeting, and instructions that could be used to misuse systems.

## Allowed And Disallowed Material

Allowed:

- High-level public education.
- Civil-liberties analysis.
- Historical and legal discussion.
- Oversight and accountability framing.
- Ethical information operations principles.
- Lawful public contact norms.
- Defensive media literacy and harm minimization.

Disallowed:

- Hacking instructions.
- Surveillance evasion instructions.
- Sensor triggering or signal-tripping guidance.
- Network scanning, packet crafting, stress-testing, or malformed request examples.
- Mass agency contact automation.
- Disinformation, harassment, impersonation, coercive influence, or psychological manipulation.
- Collecting sensitive visitor data.

## File Structure

' ' ' text
twoia-intelligence/
|-- style.css
|-- functions.php
|-- index.php
|-- front-page.php
|-- header.php
|-- footer.php
|-- single.php
|-- page.php
|-- archive.php
|-- category.php
|-- tag.php
|-- search.php
|-- 404.php
|-- comments.php
|-- inc/
|   |-- theme-setup.php
|   |-- enqueue.php
|   |-- customizer.php
|   |-- template-functions.php
|   |-- virtual-pages.php
|   |-- content-types.php
|   |-- editorial-meta.php
|   |-- seo.php
|   |-- schema.php
|   `-- content-seed.php
|-- template-parts/
|   |-- content.php
|   |-- content-card.php
|   |-- content-page.php
|   |-- content-none.php
|   |-- hero-home.php
|   |-- section-featured-briefings.php
|   |-- section-surveillance-map.php
|   |-- section-identity-framework.php
|   |-- section-osint.php
|   |-- section-anonymous.php
|   |-- section-psychological-warfare.php
|   |-- section-ethics.php
|   `-- section-newsletter.php
`-- assets/
    |-- css/theme.css
    |-- js/theme.js
    `-- images/
        |-- 2ia-home-page-top-right.png
        |-- 2ia-mark.svg
        `-- default-briefing.svg
' ' ' 

## Customizer Settings

- Hero eyebrow text
- Hero title
- Hero subtitle
- Hero body
- Hero primary button text and URL
- Hero secondary button text and URL
- Site disclaimer text
- Footer mission text
- Accent color
- Privacy-first analytics placeholder note
- Seed content admin notice toggle
- Comment display toggle

All Customizer values are sanitized before storage and escaped before output.

## Technical Notes

- Uses semantic HTML5.
- Uses vanilla JavaScript only.
- Enqueued assets use `filemtime()` versions.
- Theme JavaScript is deferred.
- CSS uses custom properties and system font stacks.
- Supports title tag, custom logo, menus, featured images, excerpts, categories, tags, search, pagination, archives, single posts, pages, 404, widgets, editor styles, Open Graph/Twitter meta, and JSON-LD schema.
- Includes a search overlay, mobile menu, copy citation link button, and JavaScript-generated table of contents for posts.
- Includes print styles for research articles.

## Deployment Checklist

- Review all Customizer text.
- Publish reviewed pages where editor-owned copy should replace fallback routes.
- Configure menus.
- Set the static homepage if desired.
- Review Privacy Policy with hosting, plugin, and form behavior.
- Avoid third-party embeds unless you accept their privacy impact.
- Test search, archives, category pages, tag pages, posts, pages, 404, keyboard navigation, and mobile menu.
- Confirm no plugin adds unwanted analytics or external assets.

## Route Content Regression Test

The site root includes `tools/Test-2IAContentRoutes.ps1` and `tools/2ia-route-content-manifest.json`. Run it against the local Studio URL before packaging or release:

' ' ' powershell
& .\tools\Test-2IAContentRoutes.ps1 -BaseUrl 'http://localhost:8904'
' ' ' 

The test checks the homepage and all source-controlled public fallback routes for HTTP 200, expected civil-liberties content, the sitewide key phrase `Lawful public intelligence for human freedom.`, and absence of PHP warning text. It also performs a static source inventory check so every virtual page slug has a manifest route and every manifest route is backed by theme source.

For CI or no-server checks, run only the source inventory and required-phrase check:

' ' ' powershell
& .\tools\Test-2IAContentRoutes.ps1 -StaticOnly
' ' ' 

## Quality Checks Expected

- PHP syntax linted for changed PHP files.
- Run `tools/Test-2IAContentRoutes.ps1` against the local Studio URL to verify every source-controlled public page still returns 200 and contains its required civil-liberties content.
- Required files present.
- No Bootstrap or jQuery enqueued.
- No external fonts or CDN dependencies.
- No tracking or analytics implementation.
- Theme functions use the `twoia_` prefix.
- Safety boundary included in README, seed content, topbar disclaimer, single briefing panels, and virtual fallback pages.