Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
31 commits
Select commit Hold shift + click to select a range
3413bb3
docs(addons): add detailed PHPDoc comments for add-on views and settings
shervElmi Apr 17, 2026
bf30bf2
docs(header): add PHPDoc comments for applications header file
shervElmi Apr 17, 2026
3359790
docs(dashboard): add PHPDoc comments for dashboard template files
shervElmi Apr 17, 2026
ac6e6ce
docs(entries): add PHPDoc comments for entry-related view files
shervElmi Apr 17, 2026
5e9be3f
docs(upsell): add PHPDoc comments for AI upsell button file
shervElmi Apr 17, 2026
2950a07
docs(fields): add PHPDoc comments for various field-related view files
shervElmi Apr 17, 2026
abec78f
docs(fields): add PHPDoc comments for single option field settings file
shervElmi Apr 17, 2026
353d08d
docs(fields): enhance PHPDoc comments for field-related view files
shervElmi Apr 17, 2026
1f928e2
refactor: update PHPDoc comments in various view files to improve cla…
shervElmi Apr 17, 2026
99e39e7
chore: update PHPStan configuration to include additional file paths …
shervElmi Apr 17, 2026
4a742ca
fix: standardize comment formatting in PHP files by correcting case i…
shervElmi Apr 17, 2026
c537710
fix: improve comment formatting and spacing in field options and comm…
shervElmi Apr 17, 2026
cd7bd4b
refactor: rename variables for clarity and improve code readability i…
shervElmi Apr 17, 2026
3b2c2f8
refactor: update variable names for consistency and enhance readabili…
shervElmi Apr 17, 2026
0500b1d
chore: replace manual Mago installation with setup action and streaml…
shervElmi Apr 17, 2026
56fff75
fix: update assertion in Add-Ons page test to check for partial text …
shervElmi Apr 17, 2026
16ff629
chore: add Carthage software Mago to composer dependencies and update…
shervElmi Apr 20, 2026
e02c880
chore: remove Carthage software Mago from composer dependencies and u…
shervElmi Apr 20, 2026
6964b74
fix: update PHPDoc comment to specify that entry object can be null i…
shervElmi Apr 20, 2026
18ad5b3
fix: correct PHPDoc type for Entry ID in sidebar-shared.php
shervElmi Apr 20, 2026
9c5811e
fix: update PHPDoc type for default_value to allow int, float, or str…
shervElmi Apr 20, 2026
548a5b8
fix: update PHPDoc type for field variable to specify it as an array …
shervElmi Apr 20, 2026
a0d5bf0
fix: update PHPDoc types for upsell visibility variables to allow nul…
shervElmi Apr 20, 2026
40a1cfc
fix: update PHPDoc types for default_value to allow int, float, or st…
shervElmi Apr 20, 2026
89569fd
fix: change href check from undefined to null in admin.js
shervElmi Apr 20, 2026
7f9c93f
fix: remove deprecated reference to _sidebar-shared-pub.php in PHPSta…
shervElmi Apr 20, 2026
953d734
fix: refactor variable names for clarity in admin.js
shervElmi Apr 21, 2026
ff81c98
fix: update PHPDoc types for default_value to allow float, int, or st…
shervElmi Apr 21, 2026
446ecbe
refactor: improve variable naming for clarity in admin.js
shervElmi Apr 21, 2026
5a10886
fix: update PHPStan configuration to streamline error handling and im…
shervElmi Apr 21, 2026
2e532f2
fix: add new path to PHPStan configuration for ignored error patterns…
shervElmi Apr 21, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions classes/views/addons/addon.php
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,10 @@
* Add-Ons addon view.
*
* @package Formidable
*
* @var array $addon Single add-on data (slug, title, display_name, excerpt, status, docs, docs_label, is_new, etc.).
* @var string $license_type Current license type or empty string.
* @var string $pricing Upgrade URL used for CTAs.
*/

if ( ! defined( 'ABSPATH' ) ) {
Expand Down
2 changes: 2 additions & 0 deletions classes/views/addons/categories.php
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,8 @@
* Add-Ons categories.
*
* @package Formidable
*
* @var array<string, array{name: string, count: int}> $categories Categories keyed by slug.
*/

if ( ! defined( 'ABSPATH' ) ) {
Expand Down
10 changes: 10 additions & 0 deletions classes/views/addons/index.php
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,16 @@
* Add-Ons Page.
*
* @package Formidable
*
* @var string $view_path Absolute path to the views/addons/ directory, with trailing slash.
* @var array $installed_addons Installed add-on plugins keyed by slug.
* @var array<string, array> $addons Available add-ons keyed by slug.
* @var array $errors API errors, if any.
* @var string $license_type Current license type or empty string.
* @var string $request_addon_url URL for requesting a new add-on.
* @var array $pro Pro add-on entry prepended to $addons.
* @var string $pricing Upgrade URL used for CTAs.
* @var array<string, array> $categories Add-on categories keyed by slug, each with 'name' and 'count'.
*/

if ( ! defined( 'ABSPATH' ) ) {
Expand Down
12 changes: 12 additions & 0 deletions classes/views/addons/list.php
Original file line number Diff line number Diff line change
@@ -1,4 +1,16 @@
<?php
/**
* Add-Ons list.
*
* @package Formidable
*
* @var array<string, array> $addons Available add-ons keyed by slug.
* @var string $view_path Absolute path to the views/addons/ directory, with trailing slash.
* @var string $request_addon_url URL for requesting a new add-on.
* @var string $license_type Current license type or empty string.
* @var string $pricing Upgrade URL used for CTAs.
*/

if ( ! defined( 'ABSPATH' ) ) {
die( 'You are not allowed to call this page directly.' );
}
Expand Down
8 changes: 8 additions & 0 deletions classes/views/addons/settings.php
Original file line number Diff line number Diff line change
@@ -1,4 +1,12 @@
<?php
/**
* Add-Ons license settings.
*
* @package Formidable
*
* @var array<string, object> $plugins Installed add-on plugin objects keyed by slug. Each has: is_parent_licence, needs_license, license, option_name, plugin_name.
*/

if ( ! defined( 'ABSPATH' ) ) {
die( 'You are not allowed to call this page directly.' );
}
Expand Down
9 changes: 9 additions & 0 deletions classes/views/applications/header.php
Original file line number Diff line number Diff line change
@@ -1,4 +1,13 @@
<?php
/**
* Applications header.
*
* @package Formidable
*
* @var string $title Header title text.
* @var string $context Current applications view context (e.g. 'index').
*/

if ( ! defined( 'ABSPATH' ) ) {
die( 'You are not allowed to call this page directly.' );
}
Expand Down
8 changes: 8 additions & 0 deletions classes/views/dashboard/templates/counters.php
Original file line number Diff line number Diff line change
@@ -1,4 +1,12 @@
<?php
/**
* Dashboard counters widget.
*
* @package Formidable
*
* @var array $template Widget data with a 'counters' array. Each counter has: heading, type, counter, cta and optional items.
*/

if ( ! defined( 'ABSPATH' ) ) {
die( 'You are not allowed to call this page directly.' );
}
Expand Down
9 changes: 9 additions & 0 deletions classes/views/dashboard/templates/entries-list.php
Original file line number Diff line number Diff line change
@@ -1,4 +1,13 @@
<?php
/**
* Dashboard entries list widget.
*
* @package Formidable
*
* @var array $template Widget data with 'widget-heading' string and 'cta' (link, label) array.
* @var FrmEntriesListHelper $wp_list_table Prepared entries list table instance (filterable via frm_entries_list_class).
*/

if ( ! defined( 'ABSPATH' ) ) {
die( 'You are not allowed to call this page directly.' );
}
Expand Down
6 changes: 6 additions & 0 deletions classes/views/dashboard/templates/license-management.php
Original file line number Diff line number Diff line change
@@ -1,4 +1,10 @@
<?php
/**
* Dashboard license management widget.
*
* @package Formidable
*/

if ( ! defined( 'ABSPATH' ) ) {
die( 'You are not allowed to call this page directly.' );
}
Expand Down
6 changes: 6 additions & 0 deletions classes/views/dashboard/templates/notification-banner.php
Original file line number Diff line number Diff line change
@@ -1,4 +1,10 @@
<?php
/**
* Dashboard welcome notification banner.
*
* @package Formidable
*/

if ( ! defined( 'ABSPATH' ) ) {
die( 'You are not allowed to call this page directly.' );
}
Expand Down
8 changes: 8 additions & 0 deletions classes/views/dashboard/templates/payment-placeholder.php
Original file line number Diff line number Diff line change
@@ -1,4 +1,12 @@
<?php
/**
* Dashboard payment placeholder widget.
*
* @package Formidable
*
* @var array $template Widget data with 'counters' and 'placeholder' (copy, cta[link, label, classname]) keys.
*/

if ( ! defined( 'ABSPATH' ) ) {
die( 'You are not allowed to call this page directly.' );
}
Expand Down
8 changes: 8 additions & 0 deletions classes/views/dashboard/templates/widget-placeholder.php
Original file line number Diff line number Diff line change
@@ -1,4 +1,12 @@
<?php
/**
* Dashboard widget placeholder.
*
* @package Formidable
*
* @var array $template Widget data with 'widget-heading' and 'placeholder' (background, heading, copy, button[link, label, classname]).
*/

if ( ! defined( 'ABSPATH' ) ) {
die( 'You are not allowed to call this page directly.' );
}
Expand Down
9 changes: 9 additions & 0 deletions classes/views/dashboard/templates/youtube-video.php
Original file line number Diff line number Diff line change
@@ -1,4 +1,13 @@
<?php
/**
* Dashboard YouTube video widget.
*
* @package Formidable
*
* @var string $classes CSS classes for the outer wrapper.
* @var array $template Widget data with 'id' (YouTube video ID).
*/

if ( ! defined( 'ABSPATH' ) ) {
die( 'You are not allowed to call this page directly.' );
}
Expand Down
10 changes: 10 additions & 0 deletions classes/views/frm-entries/_sidebar-shared-pub.php
Original file line number Diff line number Diff line change
@@ -1,4 +1,13 @@
<?php
/**
* Shared entry sidebar publish box.
*
* @package Formidable
*
* @var stdClass|null $entry Entry object (falls back to $record).
* @var stdClass|null $record Legacy entry object used when $entry is not set.
*/

if ( ! defined( 'ABSPATH' ) ) {
die( 'You are not allowed to call this page directly.' );
}
Expand All @@ -22,6 +31,7 @@
* @param string $text
* @param stdClass $entry
*/
// skipcq: PHP-W1020
$additional_timestamp_text = apply_filters( 'frm_additional_timestamp_text', '', $entry );
Comment thread
shervElmi marked this conversation as resolved.

printf(
Expand Down
11 changes: 11 additions & 0 deletions classes/views/frm-entries/errors.php
Original file line number Diff line number Diff line change
@@ -1,4 +1,15 @@
<?php
/**
* Form errors and success message wrapper.
*
* @package Formidable
*
* @var stdClass|null $form Form object when available.
* @var string|null $message Success message HTML.
* @var array|null $errors Field errors keyed by field id.
* @var string|null $include_extra_container Optional CSS class for a wrapping container.
*/

if ( ! defined( 'ABSPATH' ) ) {
die( 'You are not allowed to call this page directly.' );
}
Expand Down
12 changes: 12 additions & 0 deletions classes/views/frm-entries/show.php
Original file line number Diff line number Diff line change
@@ -1,4 +1,15 @@
<?php
/**
* Entry show page.
*
* @package Formidable
*
* @var stdClass $form Form object.
* @var stdClass $entry Entry object.
* @var array $fields Field objects for the entry.
* @var int $id Entry ID.
*/

if ( ! defined( 'ABSPATH' ) ) {
die( 'You are not allowed to call this page directly.' );
}
Expand Down Expand Up @@ -76,6 +87,7 @@
* @param array $show_args The arguments.
* @param array $args Includes `form`.
*/
// skipcq: PHP-W1020
$show_args = apply_filters( 'frm_entries_show_args', $show_args, compact( 'form' ) );
Comment thread
shervElmi marked this conversation as resolved.

echo FrmEntriesController::show_entry_shortcode( $show_args ); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
Expand Down
11 changes: 11 additions & 0 deletions classes/views/frm-entries/sidebar-shared.php
Original file line number Diff line number Diff line change
@@ -1,4 +1,15 @@
<?php
/**
* Shared entry sidebar.
*
* @package Formidable
*
* @var string $id Entry ID.
* @var stdClass $entry Entry object.
* @var string|null $browser Browser info string if available.
* @var array|null $data Additional entry meta data (referrer, user_journey, etc.).
*/

if ( ! defined( 'ABSPATH' ) ) {
die( 'You are not allowed to call this page directly.' );
}
Expand Down
10 changes: 10 additions & 0 deletions classes/views/frm-fields/back-end/ajax-field-placeholder.php
Original file line number Diff line number Diff line change
@@ -1,4 +1,14 @@
<?php
/**
* Ajax field placeholder in the form builder.
*
* @package Formidable
*
* @var object $field_object Field object with 'id', 'type', 'form_id' properties.
* @var string $li_classes Classes for the list item wrapper.
* @var array $display Display options; 'type' is used.
*/

if ( ! defined( 'ABSPATH' ) ) {
die( 'You are not allowed to call this page directly.' );
}
Expand Down
8 changes: 8 additions & 0 deletions classes/views/frm-fields/back-end/automatic-width.php
Original file line number Diff line number Diff line change
@@ -1,4 +1,12 @@
<?php
/**
* Automatic width setting for select-like fields.
*
* @package Formidable
*
* @var array $field Field data including 'id' and 'size'.
*/

if ( ! defined( 'ABSPATH' ) ) {
die( 'You are not allowed to call this page directly.' );
}
Expand Down
8 changes: 8 additions & 0 deletions classes/views/frm-fields/back-end/bulk-options-overlay.php
Original file line number Diff line number Diff line change
@@ -1,4 +1,12 @@
<?php
/**
* Bulk edit options modal.
*
* @package Formidable
*
* @var array<string, array> $prepop Preset options groups keyed by label; each may contain a 'class' key.
*/

if ( ! defined( 'ABSPATH' ) ) {
die( 'You are not allowed to call this page directly.' );
}
Expand Down
11 changes: 11 additions & 0 deletions classes/views/frm-fields/back-end/default-value-field.php
Original file line number Diff line number Diff line change
@@ -1,4 +1,15 @@
<?php
/**
* Text input for the default value setting.
*
* @package Formidable
*
* @var FrmFieldType $this Field type handler that included this template.
* @var array $field Field data including 'id' and 'field_key'.
* @var string $default_name HTML name attribute for the input.
* @var float|int|string $default_value Current default value.
*/

if ( ! defined( 'ABSPATH' ) ) {
die( 'You are not allowed to call this page directly.' );
}
Expand Down
10 changes: 10 additions & 0 deletions classes/views/frm-fields/back-end/default-value-setting.php
Original file line number Diff line number Diff line change
@@ -1,4 +1,14 @@
<?php
/**
* Default value setting in the field settings.
*
* @package Formidable
*
* @var array $field Field data including 'id', 'default_value', 'dyn_default_value'.
* @var FrmFieldType $field_obj Field type handler.
* @var array $display Display options; may include 'default_value'.
*/

if ( ! defined( 'ABSPATH' ) ) {
die( 'You are not allowed to call this page directly.' );
}
Expand Down
8 changes: 8 additions & 0 deletions classes/views/frm-fields/back-end/field-captcha.php
Original file line number Diff line number Diff line change
@@ -1,4 +1,12 @@
<?php
/**
* CAPTCHA field form builder view.
*
* @package Formidable
*
* @var string $field_name HTML name attribute for the hidden input.
*/

if ( ! defined( 'ABSPATH' ) ) {
die( 'You are not allowed to call this page directly.' );
}
Expand Down
9 changes: 9 additions & 0 deletions classes/views/frm-fields/back-end/field-choices.php
Original file line number Diff line number Diff line change
@@ -1,4 +1,13 @@
<?php
/**
* Field choices wrapper in the form builder.
*
* @package Formidable
*
* @var FrmFieldType $this Field type handler that included this template.
* @var array $args Arguments including 'field' (with 'post_field', 'id', 'taxonomy' keys).
*/

if ( ! defined( 'ABSPATH' ) ) {
die( 'You are not allowed to call this page directly.' );
}
Expand Down
8 changes: 8 additions & 0 deletions classes/views/frm-fields/back-end/field-credit-card.php
Original file line number Diff line number Diff line change
@@ -1,4 +1,12 @@
<?php
/**
* Credit card field form builder view.
*
* @package Formidable
*
* @var array $field Field data including 'form_id'.
*/

if ( ! defined( 'ABSPATH' ) ) {
die( 'You are not allowed to call this page directly.' );
}
Expand Down
8 changes: 8 additions & 0 deletions classes/views/frm-fields/back-end/field-description.php
Original file line number Diff line number Diff line change
@@ -1,4 +1,12 @@
<?php
/**
* Field description setting in the form builder.
*
* @package Formidable
*
* @var array $field Field data including 'id' and 'description'.
*/

if ( ! defined( 'ABSPATH' ) ) {
die( 'You are not allowed to call this page directly.' );
}
Expand Down
10 changes: 10 additions & 0 deletions classes/views/frm-fields/back-end/field-hidden.php
Original file line number Diff line number Diff line change
@@ -1,4 +1,14 @@
<?php
/**
* Hidden field form builder view.
*
* @package Formidable
*
* @var string $html_id HTML id attribute for the input.
* @var string $field_name HTML name attribute for the input.
* @var array $field Field data including 'default_value'.
*/

if ( ! defined( 'ABSPATH' ) ) {
die( 'You are not allowed to call this page directly.' );
}
Expand Down
Loading
Loading