Settings Dashboard

The GT Extensions settings page is your control center for all modules. Access it from Fluent Cart > GT Extensions in the WordPress admin.

Page Layout

The settings page has two main areas:

1. Module Cards — A grid of cards showing all seven modules with toggle switches
2. Module Settings — Expanded configuration panels for each enabled module

Module Cards

Each module card displays:

• Module name — The feature name (e.g., “Free Price Text”)
• Description — A one-line summary of what the module does
• Usage hint — Where to find the module’s configuration in Fluent Cart
• Toggle switch — Enable or disable the module

Hover over a card to see a subtle highlight effect. The toggle switch changes color from gray (disabled) to green (enabled).

Enabling a Module

1. Find the module card on the settings page.
2. Click the toggle switch to turn it on (green).
3. The card expands to show module-specific settings.
4. Configure the settings as needed.
5. Click Save Settings at the bottom of the page.

Changes take effect immediately after saving. There is no need to clear caches or reload pages (though caching plugins may require a purge for frontend changes to appear).

Module Settings

Each module has its own configuration section that appears when the module is enabled. Settings vary by module but typically include:

• Display text — Customizable labels and messages
• Thresholds — Numeric values that trigger behavior
• Toggle options — Sub-features you can enable or disable
• Display locations — Where the module shows its output (archive, single product, both)

All text fields support basic formatting. Placeholder tokens like {count} are replaced dynamically with actual values.

Settings Storage

All settings are saved as a single WordPress option (gtfc_settings) with this structure:

gtfc_settings = {
    "enabled_modules": ["free_price_text", "sold_count", ...],
    "module_settings": {
        "free_price_text": { ... },
        "sold_count": { ... },
        ...
    }
}

The save operation sanitizes all input recursively. Text fields are sanitized with sanitize_text_field(). Boolean values are converted from checkbox states. Numeric values are cast to integers.

Saving Settings

The form supports two save methods:

1. AJAX save (default) — Submits the form via JavaScript without a page reload. A success or error message appears at the top of the page.
2. Standard POST — If JavaScript is disabled, the form falls back to a regular form submission with a page reload.

Both methods use WordPress nonce verification for security.

Responsive Layout

The settings page adapts to screen size:

• Desktop (900px+) — Module cards display in a two-column grid
• Mobile (below 900px) — Cards stack in a single column

Common Tasks

Enable all modules: Toggle each module on individually. There is no “enable all” button by design — each module should be enabled intentionally.

Reset a module’s settings: Disable the module, save, then re-enable it. The module reloads with default values.

Check which modules are active: Look at the toggle switches on the settings page. Green means active.