Edit File by line
/home/zeestwma/richards.../wp-conte.../plugins/wpforms-.../src
File: WPForms.php
<?php
[0] Fix | Delete
[1] Fix | Delete
// phpcs:ignore Generic.Commenting.DocComment.MissingShort
[2] Fix | Delete
/** @noinspection PhpIllegalPsrClassPathInspection */
[3] Fix | Delete
[4] Fix | Delete
// phpcs:ignore Universal.Namespaces.DisallowCurlyBraceSyntax.Forbidden
[5] Fix | Delete
namespace WPForms {
[6] Fix | Delete
[7] Fix | Delete
use AllowDynamicProperties;
[8] Fix | Delete
use stdClass;
[9] Fix | Delete
use WPForms\Helpers\DB;
[10] Fix | Delete
use WPForms_Form_Handler;
[11] Fix | Delete
use WPForms_Process;
[12] Fix | Delete
use WPForms_Settings;
[13] Fix | Delete
[14] Fix | Delete
/**
[15] Fix | Delete
* Main WPForms class.
[16] Fix | Delete
*
[17] Fix | Delete
* @since 1.0.0
[18] Fix | Delete
*/
[19] Fix | Delete
#[AllowDynamicProperties]
[20] Fix | Delete
final class WPForms {
[21] Fix | Delete
[22] Fix | Delete
/**
[23] Fix | Delete
* List of screen IDs where heartbeat requests are allowed.
[24] Fix | Delete
*
[25] Fix | Delete
* @since 1.9.3
[26] Fix | Delete
*
[27] Fix | Delete
* @var string[]
[28] Fix | Delete
*/
[29] Fix | Delete
private const HEARTBEAT_ALLOWED_SCREEN_IDS = [
[30] Fix | Delete
'wpforms_page_wpforms-entries',
[31] Fix | Delete
];
[32] Fix | Delete
[33] Fix | Delete
/**
[34] Fix | Delete
* One is the loneliest number that you'll ever do.
[35] Fix | Delete
*
[36] Fix | Delete
* @since 1.0.0
[37] Fix | Delete
*
[38] Fix | Delete
* @var WPForms
[39] Fix | Delete
*/
[40] Fix | Delete
private static $instance;
[41] Fix | Delete
[42] Fix | Delete
/**
[43] Fix | Delete
* Plugin version for enqueueing, etc.
[44] Fix | Delete
* The value is got from WPFORMS_VERSION constant.
[45] Fix | Delete
*
[46] Fix | Delete
* @since 1.0.0
[47] Fix | Delete
*
[48] Fix | Delete
* @var string
[49] Fix | Delete
*/
[50] Fix | Delete
public $version = '';
[51] Fix | Delete
[52] Fix | Delete
/**
[53] Fix | Delete
* Classes registry.
[54] Fix | Delete
*
[55] Fix | Delete
* @since 1.5.7
[56] Fix | Delete
*
[57] Fix | Delete
* @var array
[58] Fix | Delete
*/
[59] Fix | Delete
private $registry = [];
[60] Fix | Delete
[61] Fix | Delete
/**
[62] Fix | Delete
* List of legacy public properties.
[63] Fix | Delete
*
[64] Fix | Delete
* @since 1.6.8
[65] Fix | Delete
*
[66] Fix | Delete
* @var string[]
[67] Fix | Delete
*/
[68] Fix | Delete
private $legacy_properties = [
[69] Fix | Delete
'form',
[70] Fix | Delete
'entry',
[71] Fix | Delete
'entry_fields',
[72] Fix | Delete
'entry_meta',
[73] Fix | Delete
'frontend',
[74] Fix | Delete
'process',
[75] Fix | Delete
'smart_tags',
[76] Fix | Delete
'license',
[77] Fix | Delete
];
[78] Fix | Delete
[79] Fix | Delete
/**
[80] Fix | Delete
* Paid returns true, free (Lite) returns false.
[81] Fix | Delete
*
[82] Fix | Delete
* @since 1.3.9
[83] Fix | Delete
* @since 1.7.3 changed to private.
[84] Fix | Delete
*
[85] Fix | Delete
* @var bool
[86] Fix | Delete
*/
[87] Fix | Delete
private $pro = false;
[88] Fix | Delete
[89] Fix | Delete
/**
[90] Fix | Delete
* Backward compatibility method for accessing the class registry in an old way,
[91] Fix | Delete
* e.g. 'wpforms()->form' or 'wpforms()->entry'.
[92] Fix | Delete
*
[93] Fix | Delete
* @since 1.5.7
[94] Fix | Delete
*
[95] Fix | Delete
* @param string $name Name of the object to get.
[96] Fix | Delete
*
[97] Fix | Delete
* @return mixed|null
[98] Fix | Delete
* @noinspection MagicMethodsValidityInspection
[99] Fix | Delete
*/
[100] Fix | Delete
public function __get( $name ) {
[101] Fix | Delete
[102] Fix | Delete
if ( $name === 'smart_tags' ) {
[103] Fix | Delete
_deprecated_argument(
[104] Fix | Delete
'wpforms()->smart_tags',
[105] Fix | Delete
'1.6.7 of the WPForms plugin',
[106] Fix | Delete
"Please use `wpforms()->obj( 'smart_tags' )` instead."
[107] Fix | Delete
);
[108] Fix | Delete
}
[109] Fix | Delete
[110] Fix | Delete
if ( $name === 'pro' ) {
[111] Fix | Delete
_deprecated_argument(
[112] Fix | Delete
'wpforms()->pro',
[113] Fix | Delete
'1.8.2.2 of the WPForms plugin',
[114] Fix | Delete
'Please use `wpforms()->is_pro()` instead.'
[115] Fix | Delete
);
[116] Fix | Delete
[117] Fix | Delete
return wpforms()->is_pro();
[118] Fix | Delete
}
[119] Fix | Delete
[120] Fix | Delete
return $this->get( $name );
[121] Fix | Delete
}
[122] Fix | Delete
[123] Fix | Delete
/**
[124] Fix | Delete
* Main WPForms Instance.
[125] Fix | Delete
*
[126] Fix | Delete
* Only one instance of WPForms exists in memory at any one time.
[127] Fix | Delete
* Also, prevent the need to define globals all over the place.
[128] Fix | Delete
*
[129] Fix | Delete
* @since 1.0.0
[130] Fix | Delete
*
[131] Fix | Delete
* @return WPForms
[132] Fix | Delete
*/
[133] Fix | Delete
public static function instance(): WPForms {
[134] Fix | Delete
[135] Fix | Delete
if ( self::$instance === null || ! self::$instance instanceof self ) {
[136] Fix | Delete
self::$instance = new self();
[137] Fix | Delete
[138] Fix | Delete
self::$instance->init();
[139] Fix | Delete
}
[140] Fix | Delete
[141] Fix | Delete
return self::$instance;
[142] Fix | Delete
}
[143] Fix | Delete
[144] Fix | Delete
/**
[145] Fix | Delete
* Initialize the plugin.
[146] Fix | Delete
*
[147] Fix | Delete
* @since 1.9.3
[148] Fix | Delete
*
[149] Fix | Delete
* @noinspection UsingInclusionOnceReturnValueInspection
[150] Fix | Delete
*/
[151] Fix | Delete
private function init() {
[152] Fix | Delete
[153] Fix | Delete
if ( self::is_restricted_heartbeat() ) {
[154] Fix | Delete
return;
[155] Fix | Delete
}
[156] Fix | Delete
[157] Fix | Delete
$this->constants();
[158] Fix | Delete
$this->includes();
[159] Fix | Delete
[160] Fix | Delete
// Load Pro or Lite specific files.
[161] Fix | Delete
if ( $this->is_pro() ) {
[162] Fix | Delete
$this->registry['pro'] = require_once WPFORMS_PLUGIN_DIR . 'pro/wpforms-pro.php';
[163] Fix | Delete
} else {
[164] Fix | Delete
require_once WPFORMS_PLUGIN_DIR . 'lite/wpforms-lite.php';
[165] Fix | Delete
}
[166] Fix | Delete
[167] Fix | Delete
$this->hooks();
[168] Fix | Delete
}
[169] Fix | Delete
[170] Fix | Delete
/**
[171] Fix | Delete
* Setup plugin constants.
[172] Fix | Delete
* All the path/URL related constants are defined in the main plugin file.
[173] Fix | Delete
*
[174] Fix | Delete
* @since 1.0.0
[175] Fix | Delete
*/
[176] Fix | Delete
private function constants() {
[177] Fix | Delete
[178] Fix | Delete
$this->version = WPFORMS_VERSION;
[179] Fix | Delete
[180] Fix | Delete
// Plugin Slug - Determine plugin type and set slug accordingly.
[181] Fix | Delete
// This filter is documented in \WPForms\WPForms::is_pro.
[182] Fix | Delete
if ( apply_filters( 'wpforms_allow_pro_version', file_exists( WPFORMS_PLUGIN_DIR . 'pro/wpforms-pro.php' ) ) ) {
[183] Fix | Delete
$this->pro = true;
[184] Fix | Delete
[185] Fix | Delete
define( 'WPFORMS_PLUGIN_SLUG', 'wpforms' );
[186] Fix | Delete
} else {
[187] Fix | Delete
define( 'WPFORMS_PLUGIN_SLUG', 'wpforms-lite' );
[188] Fix | Delete
}
[189] Fix | Delete
}
[190] Fix | Delete
[191] Fix | Delete
/**
[192] Fix | Delete
* Include files.
[193] Fix | Delete
*
[194] Fix | Delete
* @since 1.0.0
[195] Fix | Delete
*/
[196] Fix | Delete
private function includes() {
[197] Fix | Delete
[198] Fix | Delete
$this->error_handler();
[199] Fix | Delete
[200] Fix | Delete
require_once WPFORMS_PLUGIN_DIR . 'includes/class-db.php';
[201] Fix | Delete
require_once WPFORMS_PLUGIN_DIR . 'includes/functions.php';
[202] Fix | Delete
require_once WPFORMS_PLUGIN_DIR . 'includes/fields/class-base.php';
[203] Fix | Delete
[204] Fix | Delete
$this->includes_magic();
[205] Fix | Delete
[206] Fix | Delete
// Global includes.
[207] Fix | Delete
require_once WPFORMS_PLUGIN_DIR . 'includes/class-install.php';
[208] Fix | Delete
require_once WPFORMS_PLUGIN_DIR . 'includes/class-form.php';
[209] Fix | Delete
require_once WPFORMS_PLUGIN_DIR . 'includes/class-fields.php';
[210] Fix | Delete
// TODO: class-templates.php should be loaded in admin area only.
[211] Fix | Delete
require_once WPFORMS_PLUGIN_DIR . 'includes/class-templates.php';
[212] Fix | Delete
// TODO: class-providers.php should be loaded in admin area only.
[213] Fix | Delete
require_once WPFORMS_PLUGIN_DIR . 'includes/class-providers.php';
[214] Fix | Delete
require_once WPFORMS_PLUGIN_DIR . 'includes/class-process.php';
[215] Fix | Delete
require_once WPFORMS_PLUGIN_DIR . 'includes/class-widget.php';
[216] Fix | Delete
require_once WPFORMS_PLUGIN_DIR . 'includes/emails/class-emails.php';
[217] Fix | Delete
require_once WPFORMS_PLUGIN_DIR . 'includes/integrations.php';
[218] Fix | Delete
require_once WPFORMS_PLUGIN_DIR . 'includes/deprecated.php';
[219] Fix | Delete
[220] Fix | Delete
// Admin/Dashboard only includes, also in ajax.
[221] Fix | Delete
if ( is_admin() ) {
[222] Fix | Delete
require_once WPFORMS_PLUGIN_DIR . 'includes/admin/admin.php';
[223] Fix | Delete
require_once WPFORMS_PLUGIN_DIR . 'includes/admin/class-notices.php';
[224] Fix | Delete
require_once WPFORMS_PLUGIN_DIR . 'includes/admin/class-menu.php';
[225] Fix | Delete
require_once WPFORMS_PLUGIN_DIR . 'includes/admin/builder/class-builder.php';
[226] Fix | Delete
require_once WPFORMS_PLUGIN_DIR . 'includes/admin/builder/functions.php';
[227] Fix | Delete
require_once WPFORMS_PLUGIN_DIR . 'includes/admin/class-settings.php';
[228] Fix | Delete
require_once WPFORMS_PLUGIN_DIR . 'includes/admin/class-welcome.php';
[229] Fix | Delete
require_once WPFORMS_PLUGIN_DIR . 'includes/admin/class-editor.php';
[230] Fix | Delete
require_once WPFORMS_PLUGIN_DIR . 'includes/admin/class-review.php';
[231] Fix | Delete
require_once WPFORMS_PLUGIN_DIR . 'includes/admin/class-about.php';
[232] Fix | Delete
require_once WPFORMS_PLUGIN_DIR . 'includes/admin/ajax-actions.php';
[233] Fix | Delete
}
[234] Fix | Delete
}
[235] Fix | Delete
[236] Fix | Delete
/**
[237] Fix | Delete
* Hooks.
[238] Fix | Delete
*
[239] Fix | Delete
* @since 1.9.0
[240] Fix | Delete
* @since 1.9.3 No longer static.
[241] Fix | Delete
*
[242] Fix | Delete
* @return void
[243] Fix | Delete
*/
[244] Fix | Delete
private function hooks() {
[245] Fix | Delete
[246] Fix | Delete
add_action( 'plugins_loaded', [ self::$instance, 'objects' ] );
[247] Fix | Delete
add_action( 'wpforms_settings_init', [ self::$instance, 'reinstall_custom_tables' ] );
[248] Fix | Delete
}
[249] Fix | Delete
[250] Fix | Delete
/**
[251] Fix | Delete
* Include the error handler to suppress deprecated messages from vendor folders.
[252] Fix | Delete
*
[253] Fix | Delete
* @since 1.8.5
[254] Fix | Delete
*/
[255] Fix | Delete
private function error_handler() {
[256] Fix | Delete
[257] Fix | Delete
require_once WPFORMS_PLUGIN_DIR . 'src/ErrorHandler.php';
[258] Fix | Delete
[259] Fix | Delete
( new ErrorHandler() )->init();
[260] Fix | Delete
}
[261] Fix | Delete
[262] Fix | Delete
/**
[263] Fix | Delete
* Including the new files with PHP 5.3 style.
[264] Fix | Delete
*
[265] Fix | Delete
* @since 1.4.7
[266] Fix | Delete
*/
[267] Fix | Delete
private function includes_magic() { // phpcs:ignore WPForms.PHP.HooksMethod.InvalidPlaceForAddingHooks
[268] Fix | Delete
[269] Fix | Delete
// Action Scheduler requires a special loading procedure.
[270] Fix | Delete
require_once WPFORMS_PLUGIN_DIR . 'vendor/woocommerce/action-scheduler/action-scheduler.php';
[271] Fix | Delete
[272] Fix | Delete
// Autoload Composer packages.
[273] Fix | Delete
require_once WPFORMS_PLUGIN_DIR . 'vendor/autoload.php';
[274] Fix | Delete
[275] Fix | Delete
// Load the class loader.
[276] Fix | Delete
$this->register(
[277] Fix | Delete
[
[278] Fix | Delete
'name' => 'Loader',
[279] Fix | Delete
'hook' => false,
[280] Fix | Delete
]
[281] Fix | Delete
);
[282] Fix | Delete
[283] Fix | Delete
$this->register(
[284] Fix | Delete
[
[285] Fix | Delete
'name' => 'Integrations\SolidCentral\SolidCentral',
[286] Fix | Delete
'hook' => 'plugins_loaded',
[287] Fix | Delete
'priority' => 0,
[288] Fix | Delete
'condition' => ! empty( $_GET['ithemes-sync-request'] ), // phpcs:ignore WordPress.Security.NonceVerification.Recommended
[289] Fix | Delete
]
[290] Fix | Delete
);
[291] Fix | Delete
[292] Fix | Delete
/*
[293] Fix | Delete
* Load admin components. Exclude from frontend.
[294] Fix | Delete
*/
[295] Fix | Delete
if ( is_admin() ) {
[296] Fix | Delete
add_action( 'wpforms_loaded', [ '\WPForms\Admin\Loader', 'get_instance' ] );
[297] Fix | Delete
}
[298] Fix | Delete
[299] Fix | Delete
/*
[300] Fix | Delete
* Properly init the providers' loader, that will handle all the related logic and further loading.
[301] Fix | Delete
*/
[302] Fix | Delete
add_action( 'wpforms_loaded', [ '\WPForms\Providers\Providers', 'get_instance' ] );
[303] Fix | Delete
[304] Fix | Delete
/*
[305] Fix | Delete
* Properly init the integration loader, that will handle all the related logic and further loading.
[306] Fix | Delete
*/
[307] Fix | Delete
add_action( 'wpforms_loaded', [ '\WPForms\Integrations\Loader', 'get_instance' ] );
[308] Fix | Delete
}
[309] Fix | Delete
[310] Fix | Delete
/**
[311] Fix | Delete
* Setup objects.
[312] Fix | Delete
*
[313] Fix | Delete
* @since 1.0.0
[314] Fix | Delete
*/
[315] Fix | Delete
public function objects() {
[316] Fix | Delete
[317] Fix | Delete
// Global objects.
[318] Fix | Delete
$this->registry['form'] = new WPForms_Form_Handler();
[319] Fix | Delete
$this->registry['process'] = new WPForms_Process();
[320] Fix | Delete
[321] Fix | Delete
/**
[322] Fix | Delete
* Executes when all the WPForms stuff was loaded.
[323] Fix | Delete
*
[324] Fix | Delete
* @since 1.4.0
[325] Fix | Delete
*/
[326] Fix | Delete
do_action( 'wpforms_loaded' );
[327] Fix | Delete
}
[328] Fix | Delete
[329] Fix | Delete
/**
[330] Fix | Delete
* Re-create plugin custom tables if they don't exist.
[331] Fix | Delete
*
[332] Fix | Delete
* @since 1.9.0
[333] Fix | Delete
*
[334] Fix | Delete
* @param WPForms_Settings $wpforms_settings WPForms settings object.
[335] Fix | Delete
*/
[336] Fix | Delete
public function reinstall_custom_tables( WPForms_Settings $wpforms_settings ) {
[337] Fix | Delete
[338] Fix | Delete
if ( empty( $wpforms_settings->view ) ) {
[339] Fix | Delete
return;
[340] Fix | Delete
}
[341] Fix | Delete
[342] Fix | Delete
// Proceed on Settings plugin admin area page only.
[343] Fix | Delete
if ( $wpforms_settings->view !== 'general' ) {
[344] Fix | Delete
return;
[345] Fix | Delete
}
[346] Fix | Delete
[347] Fix | Delete
// Install on a current site only.
[348] Fix | Delete
if ( ! DB::custom_tables_exist() ) {
[349] Fix | Delete
DB::create_custom_tables();
[350] Fix | Delete
}
[351] Fix | Delete
}
[352] Fix | Delete
[353] Fix | Delete
/**
[354] Fix | Delete
* Register a class.
[355] Fix | Delete
*
[356] Fix | Delete
* @since 1.5.7
[357] Fix | Delete
*
[358] Fix | Delete
* @param array $class_data Class registration info.
[359] Fix | Delete
*
[360] Fix | Delete
* $class_data array accepts these params: name, id, hook, run, condition.
[361] Fix | Delete
* - name: required -- class name to register.
[362] Fix | Delete
* - id: optional -- class ID to register.
[363] Fix | Delete
* - hook: optional -- hook to register the class on -- default wpforms_loaded.
[364] Fix | Delete
* - run: optional -- method to run on class instantiation -- default init.
[365] Fix | Delete
* - condition: optional -- condition to check before registering the class.
[366] Fix | Delete
*/
[367] Fix | Delete
public function register( $class_data ): void { // phpcs:ignore Generic.Metrics.CyclomaticComplexity.TooHigh, WPForms.PHP.HooksMethod.InvalidPlaceForAddingHooks
[368] Fix | Delete
[369] Fix | Delete
if ( empty( $class_data['name'] ) || ! is_string( $class_data['name'] ) ) {
[370] Fix | Delete
return;
[371] Fix | Delete
}
[372] Fix | Delete
[373] Fix | Delete
if ( isset( $class_data['condition'] ) && empty( $class_data['condition'] ) ) {
[374] Fix | Delete
return;
[375] Fix | Delete
}
[376] Fix | Delete
[377] Fix | Delete
$full_name = $this->is_pro() ? '\WPForms\Pro\\' . $class_data['name'] : '\WPForms\Lite\\' . $class_data['name'];
[378] Fix | Delete
$full_name = class_exists( $full_name ) ? $full_name : '\WPForms\\' . $class_data['name'];
[379] Fix | Delete
[380] Fix | Delete
// Register an addon class.
[381] Fix | Delete
if ( ! empty( $class_data['addon_class'] ) && ! empty( $class_data['addon_slug'] ) ) {
[382] Fix | Delete
$is_initialized = wpforms_is_addon_initialized( $class_data['addon_slug'] ) && $this->is_pro();
[383] Fix | Delete
$full_name = $is_initialized ? $class_data['addon_class'] : $full_name;
[384] Fix | Delete
$full_name = strpos( $full_name, '\\' ) !== 0 ? '\\' . $full_name : $full_name;
[385] Fix | Delete
[386] Fix | Delete
// The core plugin classes have the priority 10.
[387] Fix | Delete
// Addon classes should be initialized after the core.
[388] Fix | Delete
$class_data['priority'] = 100;
[389] Fix | Delete
}
[390] Fix | Delete
[391] Fix | Delete
// Bail if the class doesn't exist AND it is not an addon class.
[392] Fix | Delete
if ( ! class_exists( $full_name ) && empty( $class_data['addon_class'] ) ) {
[393] Fix | Delete
return;
[394] Fix | Delete
}
[395] Fix | Delete
[396] Fix | Delete
$id = $class_data['id'] ?? '';
[397] Fix | Delete
$id = $id ? preg_replace( '/[^a-z_]/', '', (string) $id ) : $id;
[398] Fix | Delete
$hook = isset( $class_data['hook'] ) ? (string) $class_data['hook'] : 'wpforms_loaded';
[399] Fix | Delete
$run = $class_data['run'] ?? 'init';
[400] Fix | Delete
$priority = isset( $class_data['priority'] ) && is_int( $class_data['priority'] ) ? $class_data['priority'] : 10;
[401] Fix | Delete
[402] Fix | Delete
$callback = function () use ( $full_name, $id, $run, $hook ) {
[403] Fix | Delete
if ( ! class_exists( $full_name ) ) {
[404] Fix | Delete
return;
[405] Fix | Delete
}
[406] Fix | Delete
[407] Fix | Delete
// Instantiate class.
[408] Fix | Delete
$instance = new $full_name();
[409] Fix | Delete
[410] Fix | Delete
$this->register_instance( $id, $instance );
[411] Fix | Delete
[412] Fix | Delete
if ( $run && method_exists( $instance, $run ) ) {
[413] Fix | Delete
$instance->{$run}();
[414] Fix | Delete
}
[415] Fix | Delete
};
[416] Fix | Delete
[417] Fix | Delete
if ( $hook ) {
[418] Fix | Delete
add_action( $hook, $callback, $priority );
[419] Fix | Delete
} else {
[420] Fix | Delete
$callback();
[421] Fix | Delete
}
[422] Fix | Delete
}
[423] Fix | Delete
[424] Fix | Delete
/**
[425] Fix | Delete
* Register any class instance.
[426] Fix | Delete
*
[427] Fix | Delete
* @since 1.8.6
[428] Fix | Delete
*
[429] Fix | Delete
* @param string $id Class ID.
[430] Fix | Delete
* @param object $instance Any class instance (object).
[431] Fix | Delete
*/
[432] Fix | Delete
public function register_instance( $id, $instance ) {
[433] Fix | Delete
[434] Fix | Delete
if ( $id && is_object( $instance ) && ! array_key_exists( $id, $this->registry ) ) {
[435] Fix | Delete
$this->registry[ $id ] = $instance;
[436] Fix | Delete
}
[437] Fix | Delete
}
[438] Fix | Delete
[439] Fix | Delete
/**
[440] Fix | Delete
* Register classes in bulk.
[441] Fix | Delete
*
[442] Fix | Delete
* @since 1.5.7
[443] Fix | Delete
*
[444] Fix | Delete
* @param array $classes Classes to register.
[445] Fix | Delete
*/
[446] Fix | Delete
public function register_bulk( $classes ) {
[447] Fix | Delete
[448] Fix | Delete
if ( ! is_array( $classes ) ) {
[449] Fix | Delete
return;
[450] Fix | Delete
}
[451] Fix | Delete
[452] Fix | Delete
foreach ( $classes as $class ) {
[453] Fix | Delete
$this->register( $class );
[454] Fix | Delete
}
[455] Fix | Delete
}
[456] Fix | Delete
[457] Fix | Delete
/**
[458] Fix | Delete
* Get a class instance from a registry.
[459] Fix | Delete
* Use \WPForms\WPForms::obj() instead.
[460] Fix | Delete
*
[461] Fix | Delete
* @since 1.5.7
[462] Fix | Delete
* @deprecated 1.9.1
[463] Fix | Delete
*
[464] Fix | Delete
* @param string $name Class name or an alias.
[465] Fix | Delete
*
[466] Fix | Delete
* @return mixed|stdClass|null
[467] Fix | Delete
*/
[468] Fix | Delete
public function get( $name ) {
[469] Fix | Delete
[470] Fix | Delete
if ( ! empty( $this->registry[ $name ] ) ) {
[471] Fix | Delete
return $this->registry[ $name ];
[472] Fix | Delete
}
[473] Fix | Delete
[474] Fix | Delete
// Backward compatibility for old public properties.
[475] Fix | Delete
// Return null to save old condition for these properties.
[476] Fix | Delete
if ( in_array( $name, $this->legacy_properties, true ) ) {
[477] Fix | Delete
return $this->{$name} ?? null;
[478] Fix | Delete
}
[479] Fix | Delete
[480] Fix | Delete
return new stdClass();
[481] Fix | Delete
}
[482] Fix | Delete
[483] Fix | Delete
/**
[484] Fix | Delete
* Get a class instance from a registry.
[485] Fix | Delete
*
[486] Fix | Delete
* @since 1.9.1
[487] Fix | Delete
*
[488] Fix | Delete
* @param string $name Class name or an alias.
[489] Fix | Delete
*
[490] Fix | Delete
* @return object|null
[491] Fix | Delete
*/
[492] Fix | Delete
public function obj( string $name ) {
[493] Fix | Delete
[494] Fix | Delete
return $this->registry[ $name ] ?? null;
[495] Fix | Delete
}
[496] Fix | Delete
[497] Fix | Delete
/**
[498] Fix | Delete
* Get the list of all custom tables starting with `wpforms_*`.
[499] Fix | Delete
12
It is recommended that you Edit text format, this type of Fix handles quite a lot in one request
Function