Feresta - Automatic Gateway Setup

Author: Ariya Sarrafzadeh Version: 1.4.1

A WordPress plugin that automatically registers the Feresta SMS gateway (PersiaFava) inside popular Iranian SMS-sending plugins, so site owners don't have to hand-build an integration for each one.

Supported plugins

Project structure

feresta-gateway.php              Main plugin file - dashboard menu, gateway hooks, activation/deactivation
includes/
  dashboard/
    dashboard.php                Main dashboard UI (tabbed: account settings / supported plugins)
    supported-plugins.php        Per-plugin install/setup status table + troubleshooting guide
  gateways/
    wp-sms/
      class-wpsms-gateway-feresta.php   Gateway class copied into the WP SMS plugin folder
      integrator.php                     Copy helper
    digits/
      app.js                             Admin-side helper script for the Digits settings screen
    wooCommerce-sms/
      Feresta.php                        Gateway class for the new PW\PWSMS\Gateways architecture
      ws-class-integrator.php            Copies Feresta.php into Persian WooCommerce SMS, always refreshed
      ws-bridge.php                      Reflection-based tjp-slot override for the old plugin architecture
                                          + admin notice diagnostics for whichever architecture is detected
  utils/
    api-handler.php              Shared Feresta API request helper
    helpers.php                  Plugin-detection / normalization utilities
assets/
  dashboard.css                  Dark, translucent dashboard theme (CSS custom properties / design tokens)
  dashboard.js                   Dashboard interactivity (edit/cancel account info, retry connection)

Known limitations

• Auto-select on activation is currently only implemented for WP SMS. Digits and Persian WooCommerce SMS don't have a verified, safe-to-guess option key for "currently active gateway" - guessing wrong here risks silently doing nothing rather than crashing, but it's still not implemented until the real option key is confirmed from source.
• The tjp-slot override (old Persian WooCommerce SMS architecture) permanently repurposes that gateway slot while Feresta is active. If a site was genuinely using the real tjp.ir service through that slot, it becomes unavailable.
• Digits' credential-reading logic in feresta-gateway.php (feresta_digits_get_credentials() / related helpers) uses a "search every plausible option name" fallback approach, since Digits' exact settings-storage schema isn't publicly documented and varies between installs.

Development notes

• All source comments are in English; user-facing admin UI strings are in Persian (the target audience is Iranian WordPress site owners).
• Every gateway-copy operation is guarded against crashing the host site: files check for the existence of required parent classes/interfaces before declaring anything, and integrations fail silently (with an error_log entry and/or admin notice) rather than fataling.
• Version numbers in feresta-gateway.php (Version: header + FERESTA_VERSION constant) should be bumped together on every release.

Repository version history

This repository was assembled from 12 release zips — one commit per version in chronological order, each tagged with its release number. Tagged trees are byte-identical to the original zips (line endings normalized to LF in git).

Full details: CHANGELOG.md.

Packaging a release zip

The installable zip must contain the plugin files inside a top-level Ferestaa/ folder. Build it straight from a tag (.gitignore, .gitattributes and CHANGELOG.md are marked export-ignore, so they stay out of the archive):

git archive --format=zip --prefix=Ferestaa/ -o Ferestaa-v1.5.2.zip v1.5.2