CMS Project Sync
This commit is contained in:
+361
@@ -0,0 +1,361 @@
|
||||
<?php
|
||||
|
||||
// phpcs:ignore Generic.Commenting.DocComment.MissingShort
|
||||
/** @noinspection AutoloadingIssuesInspection */
|
||||
|
||||
/**
|
||||
* Base form template.
|
||||
*
|
||||
* @since 1.0.0
|
||||
*/
|
||||
abstract class WPForms_Template {
|
||||
|
||||
/**
|
||||
* Full name of the template, e.g. "Contact Form".
|
||||
*
|
||||
* @since 1.0.0
|
||||
*
|
||||
* @var string
|
||||
*/
|
||||
public $name;
|
||||
|
||||
/**
|
||||
* Slug of the template, e.g. "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 of 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 = '';
|
||||
|
||||
/**
|
||||
* Form template preview URL.
|
||||
*
|
||||
* @since 1.7.5.3
|
||||
*
|
||||
* @var string
|
||||
*/
|
||||
public $url = '';
|
||||
|
||||
/**
|
||||
* Form template thumbnail URL.
|
||||
*
|
||||
* @since 1.8.2
|
||||
*
|
||||
* @var string
|
||||
*/
|
||||
public $thumbnail = '';
|
||||
|
||||
/**
|
||||
* 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();
|
||||
|
||||
// Hooks.
|
||||
$this->hooks();
|
||||
}
|
||||
|
||||
/**
|
||||
* Let's get started.
|
||||
*
|
||||
* @since 1.0.0
|
||||
*/
|
||||
public function init() {}
|
||||
|
||||
/**
|
||||
* Register hooks.
|
||||
*
|
||||
* @since 1.9.9
|
||||
*/
|
||||
private function hooks(): void {
|
||||
|
||||
$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 );
|
||||
}
|
||||
|
||||
/**
|
||||
* Add basic template details to the Add New Form admin screen.
|
||||
*
|
||||
* @since 1.0.0
|
||||
*
|
||||
* @param array|mixed $templates Templates array.
|
||||
*
|
||||
* @return array
|
||||
*/
|
||||
public function template_details( $templates ): array {
|
||||
|
||||
$templates = (array) $templates;
|
||||
|
||||
$templates[] = [
|
||||
'name' => $this->name,
|
||||
'slug' => $this->slug,
|
||||
'source' => $this->source,
|
||||
'categories' => $this->categories,
|
||||
'description' => $this->description,
|
||||
'includes' => $this->includes,
|
||||
'icon' => $this->icon,
|
||||
'url' => ! empty( $this->url ) ? $this->url : '',
|
||||
'plugin_dir' => $this->get_plugin_dir(),
|
||||
'thumbnail' => ! empty( $this->thumbnail ) ? $this->thumbnail : '',
|
||||
];
|
||||
|
||||
return $templates;
|
||||
}
|
||||
|
||||
/**
|
||||
* Get the directory name of the plugin in which the current template resides.
|
||||
*
|
||||
* @since 1.6.9
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
private function get_plugin_dir(): string {
|
||||
|
||||
$reflection = new ReflectionClass( $this );
|
||||
$template_file_path = wp_normalize_path( $reflection->getFileName() );
|
||||
|
||||
// Cutting out the WP_PLUGIN_DIR from the beginning of the template file path.
|
||||
$template_file_path = preg_replace( '{^' . wp_slash( wp_normalize_path( WP_PLUGIN_DIR ) ) . '}', '', $template_file_path );
|
||||
|
||||
$template_file_chunks = explode( '/', $template_file_path );
|
||||
|
||||
return $template_file_chunks[1];
|
||||
}
|
||||
|
||||
/**
|
||||
* Add template data when a 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 ): array {
|
||||
|
||||
if ( empty( $data['template'] ) || $data['template'] !== $this->slug ) {
|
||||
return $args;
|
||||
}
|
||||
|
||||
// Enable Notifications by default.
|
||||
$this->data['settings']['notification_enable'] = $this->data['settings']['notification_enable'] ?? '1';
|
||||
|
||||
/**
|
||||
* Allow modifying form data when a template is applied to the new form.
|
||||
*
|
||||
* @since 1.9.0
|
||||
*
|
||||
* @param array $form_data New form data.
|
||||
*/
|
||||
$this->data = (array) apply_filters( 'wpforms_templates_class_base_template_modify_data', $this->data );
|
||||
|
||||
$args['post_content'] = wpforms_encode( $this->data );
|
||||
|
||||
return $args;
|
||||
}
|
||||
|
||||
/**
|
||||
* Replace the 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
|
||||
* @noinspection PhpMissingParamTypeInspection
|
||||
*/
|
||||
public function template_replace( $form, $data, $args ): array {
|
||||
|
||||
// We should proceed only if the template slug passed via $args['template'] is equal to the current template slug.
|
||||
// This will work only for offline templates: Blank Form, all the Addons Templates, and all the custom templates.
|
||||
// All the online (modern) templates use the hash as the identifier,
|
||||
// and they are handled by `\WPForms\Admin\Builder\Templates::apply_to_existing_form()`.
|
||||
if ( empty( $args['template'] ) || $args['template'] !== $this->slug ) {
|
||||
return $form;
|
||||
}
|
||||
|
||||
$form_data = wpforms_decode( wp_unslash( $form['post_content'] ) );
|
||||
|
||||
// Something is wrong with the form data.
|
||||
if ( empty( $form_data ) ) {
|
||||
return $form;
|
||||
}
|
||||
|
||||
// Compile the new form data while preserving the necessary data from the existing form.
|
||||
$new = $this->data;
|
||||
$new['id'] = $form_data['id'] ?? 0;
|
||||
$new['settings'] = $form_data['settings'] ?? [];
|
||||
$new['payments'] = $form_data['payments'] ?? [];
|
||||
$new['meta'] = $form_data['meta'] ?? [];
|
||||
|
||||
$template_id = $this->data['meta']['template'] ?? '';
|
||||
|
||||
// Preserve template ID `wpforms-user-template-{$form_id}` when overwriting it with the core template.
|
||||
if ( wpforms_is_form_template( $form['ID'] ) ) {
|
||||
$template_id = $form_data['meta']['template'] ?? '';
|
||||
}
|
||||
|
||||
$new['meta']['template'] = $template_id;
|
||||
|
||||
/**
|
||||
* Allow modifying form data when a template is replaced.
|
||||
*
|
||||
* @since 1.7.9
|
||||
*
|
||||
* @param array $new Updated form data.
|
||||
* @param array $form_data Current form data.
|
||||
* @param array $template Template data.
|
||||
*/
|
||||
$new = (array) apply_filters( 'wpforms_templates_class_base_template_replace_modify_data', $new, $form_data, $this );
|
||||
|
||||
// Update the form with new data.
|
||||
$form['post_content'] = wpforms_encode( $new );
|
||||
|
||||
return $form;
|
||||
}
|
||||
|
||||
/**
|
||||
* Pass information about the active template back to the builder.
|
||||
*
|
||||
* @since 1.0.0
|
||||
*
|
||||
* @param array|mixed $details Details.
|
||||
* @param WP_Post|null|false $form Form data.
|
||||
*
|
||||
* @return array
|
||||
*/
|
||||
public function template_active( $details, $form ): array {
|
||||
|
||||
$details = (array) $details;
|
||||
|
||||
if ( ! $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;
|
||||
}
|
||||
|
||||
$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 logic to determine whether the template informational modal screens
|
||||
* should be displayed.
|
||||
*
|
||||
* @since 1.0.0
|
||||
*
|
||||
* @param array $form_data Form data and settings.
|
||||
*
|
||||
* @return bool
|
||||
*/
|
||||
public function template_modal_conditional( $form_data ) { // phpcs:ignore Generic.CodeAnalysis.UnusedFunctionParameter.Found
|
||||
|
||||
return false;
|
||||
}
|
||||
}
|
||||
+78
@@ -0,0 +1,78 @@
|
||||
<?php
|
||||
|
||||
// phpcs:disable Generic.Commenting.DocComment.MissingShort
|
||||
/** @noinspection AutoloadingIssuesInspection */
|
||||
/** @noinspection PhpIllegalPsrClassPathInspection */
|
||||
// phpcs:enable Generic.Commenting.DocComment.MissingShort
|
||||
|
||||
if ( ! defined( 'ABSPATH' ) ) {
|
||||
exit;
|
||||
}
|
||||
|
||||
/**
|
||||
* Blank form template.
|
||||
*
|
||||
* @since 1.0.0
|
||||
*/
|
||||
class WPForms_Template_Blank extends WPForms_Template {
|
||||
|
||||
/**
|
||||
* Template slug.
|
||||
*
|
||||
* @since 1.9.2
|
||||
*/
|
||||
const SLUG = 'blank';
|
||||
|
||||
/**
|
||||
* Primary class constructor.
|
||||
*
|
||||
* @since 1.0.0
|
||||
*/
|
||||
public function init() {
|
||||
|
||||
$this->priority = 1;
|
||||
$this->name = esc_html__( 'Blank Form', 'wpforms-lite' );
|
||||
$this->slug = 'blank';
|
||||
$this->source = 'wpforms-core';
|
||||
$this->categories = 'all';
|
||||
$this->description = esc_html__( 'The blank form allows you to create any type of form using our drag & drop builder.', 'wpforms-lite' );
|
||||
$this->includes = '';
|
||||
$this->icon = '';
|
||||
$this->modal = '';
|
||||
$this->core = true;
|
||||
$this->data = self::get_data();
|
||||
}
|
||||
|
||||
/**
|
||||
* Get template data.
|
||||
*
|
||||
* @since 1.9.2
|
||||
*
|
||||
* @return array
|
||||
*/
|
||||
public static function get_data(): array {
|
||||
|
||||
return [
|
||||
'field_id' => '1',
|
||||
'fields' => [],
|
||||
'settings' => [
|
||||
'antispam_v3' => '1',
|
||||
'ajax_submit' => '1',
|
||||
'confirmation_message_scroll' => '1',
|
||||
'submit_text_processing' => esc_html__( 'Sending...', 'wpforms-lite' ),
|
||||
'store_spam_entries' => '1',
|
||||
'anti_spam' => [
|
||||
'time_limit' => [
|
||||
'enable' => '1',
|
||||
'duration' => '2',
|
||||
],
|
||||
],
|
||||
],
|
||||
'meta' => [
|
||||
'template' => self::SLUG,
|
||||
],
|
||||
];
|
||||
}
|
||||
}
|
||||
|
||||
new WPForms_Template_Blank();
|
||||
+86
@@ -0,0 +1,86 @@
|
||||
<?php
|
||||
|
||||
if ( ! defined( 'ABSPATH' ) ) {
|
||||
exit;
|
||||
}
|
||||
|
||||
/**
|
||||
* Simple Contact Form Template for WPForms.
|
||||
*
|
||||
* @since 1.7.5.3
|
||||
*/
|
||||
class WPForms_Template_Simple_Contact_Form extends WPForms_Template {
|
||||
|
||||
/**
|
||||
* Primary class constructor.
|
||||
*
|
||||
* @since 1.7.5.3
|
||||
*/
|
||||
public function init() {
|
||||
|
||||
$this->name = esc_html__( 'Simple Contact Form', 'wpforms-lite' );
|
||||
$this->priority = 1;
|
||||
$this->source = 'wpforms-core';
|
||||
$this->categories = 'all';
|
||||
$this->core = true;
|
||||
$this->slug = 'simple-contact-form-template';
|
||||
$this->url = 'https://wpforms.com/templates/simple-contact-form-template/';
|
||||
$this->description = esc_html__( 'Collect the names, emails, and messages from site visitors that need to talk to you.', 'wpforms-lite' );
|
||||
$this->thumbnail = esc_url( WPFORMS_PLUGIN_URL . 'assets/images/thumbnail-simple-contact-form-template.jpg' );
|
||||
$this->data = [
|
||||
'fields' => [
|
||||
'1' => [
|
||||
'id' => '1',
|
||||
'type' => 'name',
|
||||
'format' => 'first-last',
|
||||
'label' => esc_html__( 'Name', 'wpforms-lite' ),
|
||||
'required' => '1',
|
||||
'size' => 'medium',
|
||||
],
|
||||
'2' => [
|
||||
'id' => '2',
|
||||
'type' => 'email',
|
||||
'label' => esc_html__( 'Email', 'wpforms-lite' ),
|
||||
'required' => '1',
|
||||
'size' => 'medium',
|
||||
],
|
||||
'3' => [
|
||||
'id' => '3',
|
||||
'type' => 'textarea',
|
||||
'label' => esc_html__( 'Comment or Message', 'wpforms-lite' ),
|
||||
'size' => 'medium',
|
||||
'placeholder' => '',
|
||||
'css' => '',
|
||||
],
|
||||
],
|
||||
'field_id' => 4,
|
||||
'settings' => [
|
||||
'form_desc' => '',
|
||||
'submit_text' => esc_html__( 'Submit', 'wpforms-lite' ),
|
||||
'submit_text_processing' => esc_html__( 'Sending...', 'wpforms-lite' ),
|
||||
'antispam_v3' => '1',
|
||||
'notification_enable' => '1',
|
||||
'notifications' => [
|
||||
'1' => [
|
||||
'email' => '{admin_email}',
|
||||
'replyto' => '{field_id="2"}',
|
||||
'message' => '{all_fields}',
|
||||
],
|
||||
],
|
||||
'confirmations' => [
|
||||
'1' => [
|
||||
'type' => 'message',
|
||||
'message' => esc_html__( 'Thanks for contacting us! We will be in touch with you shortly.', 'wpforms-lite' ),
|
||||
'message_scroll' => '1',
|
||||
],
|
||||
],
|
||||
'ajax_submit' => '1',
|
||||
],
|
||||
'meta' => [
|
||||
'template' => $this->slug,
|
||||
],
|
||||
];
|
||||
}
|
||||
}
|
||||
|
||||
new WPForms_Template_Simple_Contact_Form();
|
||||
Reference in New Issue
Block a user