Base class for a submodule.
Description
Source
File: src/modules/submodule.php
abstract class Submodule { /** * The submodule slug. Must match the slug when registering the submodule. * * @since 1.0.0 * @var string */ protected $slug = ''; /** * The submodule title. * * @since 1.0.0 * @var string */ protected $title = ''; /** * The submodule description. * * @since 1.0.0 * @var string */ protected $description = ''; /** * Logging context for this submodule. * * @since 1.0.0 * @var array */ protected $logging_context = array(); /** * The submodules module instance. * * @since 1.0.0 * @var Module */ protected $module; /** * Constructor. * * @since 1.0.0 * * @param Module $module The submodule's parent module instance. */ public function __construct( $module ) { $this->module = $module; $this->bootstrap(); $this->logging_context = array( 'module' => $this->module->get_slug(), 'submodule' => $this->get_slug(), ); } /** * Returns the submodule slug. * * @since 1.0.0 * * @return string Submodule slug. */ public function get_slug() { return $this->slug; } /** * Returns the submodule title. * * @since 1.0.0 * * @return string Submodule title. */ public function get_title() { return $this->title; } /** * Returns the submodule description. * * @since 1.0.0 * * @return string Submodule description. */ public function get_description() { return $this->description; } /** * Bootstraps the submodule by setting properties. * * @since 1.0.0 */ protected abstract function bootstrap(); }
Changelog
Version | Description |
---|---|
1.0.0 | Introduced. |
Methods
- enabled — Checks whether the protector is enabled for a specific form.
- get_meta_fields — Returns the available meta fields for the submodule.
- render_output — Renders the output for the protector before the Submit button.
- verify_request — Verifies a request by ensuring that it is not spammy.
- wrap_form_name — Wraps a non-prefixed form input name attribute so that it will be properly included the submission POST data.