| Dir : /home/trave494/v1world.us/wp-content/plugins/wpforms-lite/includes/templates/ |
| Server: Linux ngx353.inmotionhosting.com 4.18.0-553.22.1.lve.1.el8.x86_64 #1 SMP Tue Oct 8 15:52:54 UTC 2024 x86_64 IP: 209.182.202.254 |
| Dir : //home/trave494/v1world.us/wp-content/plugins/wpforms-lite/includes/templates/class-base.php |
<?php
/**
* Base form template.
*
* @since 1.0.0
*/
abstract class WPForms_Template {
/**
* Full name of the template, eg "Contact Form".
*
* @since 1.0.0
*
* @var string
*/
public $name;
/**
* Slug of the template, eg "contact-form" - no spaces.
*
* @since 1.0.0
*
* @var string
*/
public $slug;
/**
* Source of the template.
*
* @since 1.6.8
*
* @var array
*/
public $source;
/**
* Categories array.
*
* @since 1.6.8
*
* @var array
*/
public $categories;
/**
* Short description the template.
*
* @since 1.0.0
*
* @var string
*/
public $description = '';
/**
* Short description of the fields included with the template.
*
* @since 1.0.0
*
* @var string
*/
public $includes = '';
/**
* URL of the icon to display in the admin area.
*
* @since 1.0.0
*
* @var string
*/
public $icon = '';
/**
* Array of data that is assigned to the post_content on form creation.
*
* @since 1.0.0
*
* @var array
*/
public $data;
/**
* Priority to show in the list of available templates.
*
* @since 1.0.0
*
* @var int
*/
public $priority = 20;
/**
* Core or additional template.
*
* @since 1.4.0
*
* @var bool
*/
public $core = false;
/**
* Modal message to display when the template is applied.
*
* @since 1.0.0
*
* @var array
*/
public $modal = '';
/**
* Primary class constructor.
*
* @since 1.0.0
*/
public function __construct() {
// Bootstrap.
$this->init();
$type = $this->core ? '_core' : '';
add_filter( "wpforms_form_templates{$type}", [ $this, 'template_details' ], $this->priority );
add_filter( 'wpforms_create_form_args', [ $this, 'template_data' ], 10, 2 );
add_filter( 'wpforms_save_form_args', [ $this, 'template_replace' ], 10, 3 );
add_filter( 'wpforms_builder_template_active', [ $this, 'template_active' ], 10, 2 );
}
/**
* Let's get started.
*
* @since 1.0.0
*/
public function init() {}
/**
* Add basic template details to the Add New Form admin screen.
*
* @since 1.0.0
*
* @param array $templates Templates array.
*
* @return array
*/
public function template_details( $templates ) {
$templates[] = [
'name' => $this->name,
'slug' => $this->slug,
'source' => $this->source,
'categories' => $this->categories,
'description' => $this->description,
'includes' => $this->includes,
'icon' => $this->icon,
];
return $templates;
}
/**
* Add template data when form is created.
*
* @since 1.0.0
*
* @param array $args Create form arguments.
* @param array $data Template data.
*
* @return array
*/
public function template_data( $args, $data ) {
if ( ! empty( $data ) && ! empty( $data['template'] ) ) {
if ( $data['template'] === $this->slug ) {
// Enable Notifications by default.
$this->data['settings']['notification_enable'] = isset( $this->data['settings']['notification_enable'] )
? $this->data['settings']['notification_enable']
: 1;
$args['post_content'] = wpforms_encode( $this->data );
}
}
return $args;
}
/**
* Replace template on post update if triggered.
*
* @since 1.0.0
*
* @param array $form Form post data.
* @param array $data Form data.
* @param array $args Update form arguments.
*
* @return array
*/
public function template_replace( $form, $data, $args ) {
if ( ! empty( $args['template'] ) ) {
if ( $args['template'] === $this->slug ) {
$new = $this->data;
$new['settings'] = ! empty( $form['post_content']['settings'] ) ? $form['post_content']['settings'] : [];
$form['post_content'] = wpforms_encode( $new );
}
}
return $form;
}
/**
* Pass information about the active template back to the builder.
*
* @since 1.0.0
*
* @param array $details Details.
* @param object $form Form data.
*
* @return array|void
*/
public function template_active( $details, $form ) {
if ( empty( $form ) ) {
return;
}
$form_data = wpforms_decode( $form->post_content );
if ( empty( $this->modal ) || empty( $form_data['meta']['template'] ) || $this->slug !== $form_data['meta']['template'] ) {
return $details;
} else {
$display = $this->template_modal_conditional( $form_data );
}
return [
'name' => $this->name,
'slug' => $this->slug,
'description' => $this->description,
'includes' => $this->includes,
'icon' => $this->icon,
'modal' => $this->modal,
'modal_display' => $display,
];
}
/**
* Conditional to determine if the template informational modal screens
* should display.
*
* @since 1.0.0
*
* @param array $form_data Form data and settings.
*
* @return bool
*/
public function template_modal_conditional( $form_data ) {
return false;
}
}