SPARXSTAR 3IAtlas Dictionary

A comprehensive WordPress plugin for managing dictionary entries with full WPGraphQL and SCF (Secure Custom Fields) integration. This plugin provides a dynamic React-based frontend dictionary interface and a robust backend management system.

🚀 Features

• Dictionary Management: Custom Post Type (aiwa_cpt_dictionary) for managing word entries.
• Rich Taxonomies: Categorize words by:
  • Language (starmus_tax_language)
  • Dialect (starmus_tax_dialect)
  • Part of Speech (starmus_part_of_speech)
  • Alphabetical Grouping (aiwa-alpha-letter)
• GraphQL Integration: Full schema exposure for headless or decoupled applications.
• SCF Integration: Dynamic schema generation based on acf-json configurations.
• React Frontend: Built-in, high-performance dictionary viewer with:
  • Virtual scrolling for large datasets.
  • Instant search with debouncing.
  • Audio pronunciation support.
  • English/French toggles.
• Frontend Submission: Shortcode-based form for contributors to suggest new entries.

📋 Requirements

• PHP: 8.2 or higher
• WordPress: 6.4 or higher
• Plugins:
  • WPGraphQL (Required for API)
  • Secure Custom Fields (SCF) PRO or Free (Required for data structure)

🛠️ Installation

1. Clone or download the repository into your wp-content/plugins/ directory.

2. This project uses pnpm for JS dependencies (enable it with corepack enable). Install dependencies and build the assets:

    corepack enable        # one-time: provisions the pinned pnpm version
    pnpm install
    pnpm run build

3. Activate the plugin through the WordPress admin interface.

4. Ensure SCF and WPGraphQL are installed and active.

5. Navigate to Custom Field > Tools > Sync to ensure the fields are correctly registered from acf-json.

💻 Usage

For detailed guides and notes, see the docs/ directory.

Shortcodes

Frontend Dictionary Enable users to browse the dictionary. Words are displayed alphabetically with an A-Z index to quickly jump to words beginning with the selected letter. When clicked, the definition, proununciation, example sentences, audio, images and more are displayed for each word. Users can scroll by word or scroll the full view, just like in a printed dictionary.

[sparxstar_dictionary]

Standalone full-page app

The same dictionary is also served as its own full-screen page (no theme header/footer), which is useful for kiosks, deep links, and embedding:

• Pretty URL: https://your-site.com/dictionary/
• Always-available fallback (works before permalinks are flushed): https://your-site.com/?sparxstar_dictionary_app=1

The slug defaults to dictionary; change it with the sparxstar_dictionary_app_slug filter. After changing the slug (or first activation) visit Settings → Permalinks once to flush rewrite rules.

Embed as an iframe

<iframe src="https://your-site.com/dictionary/"
        style="width:100%;height:100dvh;border:0"
        title="Dictionary" loading="lazy"></iframe>

The standalone page is framable from any origin by default (it is public, read-only content). To restrict which sites may embed it, return an array of allowed origins from the sparxstar_dictionary_frame_ancestors filter — this emits a Content-Security-Policy: frame-ancestors allowlist.

Frontend Submission Form Enable logged-in users (Contributors/Editors) to add or edit dictionary entries directly from the frontend.

[sparxstar_dictionary_form]

Attributes:

• entry_id (optional): The ID of the dictionary entry to edit.

Example:

[sparxstar_dictionary_form entry_id="123"]

GraphQL API

The plugin registers a dictionaries root query in the GraphQL schema.

Sample Query:

query GetDictionaryEntries {
    dictionaries(first: 10) {
        edges {
            node {
                title
                aiwaWordDetails {
                    aiwaTranslationEnglish
                    aiwaTranslationFrench
                    aiwaPartOfSpeech
                    aiwaExampleSentences {
                        aiwaSentence
                        aiwaSTranslationEnglish
                    }
                }
                starmusTaxLanguages {
                    nodes {
                        name
                    }
                }
            }
        }
    }
}

🏗️ Development

Architecture

• Root: sparxstar-3iatlas-dictionary.php (Bootloader)
• Core Logic: src/core/SparxstarIAtlasOrchestrator.php
• Post Types: src/includes/SparxstarIAtlasPostTypes.php
• Frontend: src/js/app.jsx (React Application)

Build Commands

• pnpm run build: Compile and minify assets for production.
• pnpm run watch: specific watch command for development.
• pnpm run lint: Run ESLint and Stylelint.

🤝 Contributing

1. Follow the PSR-4 coding standard for PHP.
2. Ensure React components in src/js are functional and use hooks.

📄 License

License: Starisian Technologies Proprietary License (STPD) Copyright (c) 2026 Starisian Technologies. All rights reserved.

SPARXSTAR and Starisian Technologies is a trademark of Starisian Technologies.

NOTICE: All information contained herein is, and remains, the property of Starisian Technologies and its suppliers, if any. The intellectual and technical concepts contained herein are proprietary to Starisian Technologies and its suppliers and may be protected by U.S. and international copyright, trade secret, and patent laws, including patents in process.

Unauthorized reproduction, redistribution, transmission, or disclosure of any part of this repository is strictly prohibited without prior written consent from Starisian Technologies.