[form_name]
[/if form_name] [if form_description][form_description]
[/if form_description]
BEFORE_HTML;
} else {
$default_html = '';
}
return $default_html;
}
public static function get_draft_link() {
$link = '[if save_draft][draft_label][/if save_draft]';
return $link;
}
/**
* Gets start over button shortcode.
*
* @since 5.4
*
* @return string
*/
public static function get_start_over_shortcode() {
return '[if start_over][start_over_label][/if start_over]';
}
public static function get_custom_submit( $html, $form, $submit, $form_action, $values ) {
$button = self::replace_shortcodes( $html, $form, $submit, $form_action, $values );
if ( ! strpos( $button, '[button_action]' ) ) {
echo FrmAppHelper::maybe_kses( $button ); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
return;
}
/**
* @since 5.0.06
*/
$button = apply_filters( 'frm_submit_button_html', $button, compact( 'form' ) );
if ( FrmAppHelper::should_never_allow_unfiltered_html() ) {
$button = FrmAppHelper::kses_submit_button( $button );
}
$button_parts = explode( '[button_action]', $button );
$classes = apply_filters( 'frm_submit_button_class', array(), $form );
if ( ! empty( $classes ) ) {
$classes = implode( ' ', $classes );
$button_class = ' class="frm_button_submit';
if ( strpos( $button_parts[0], $button_class ) !== false ) {
$button_parts[0] = str_replace( $button_class, $button_class . ' ' . esc_attr( $classes ), $button_parts[0] );
} else {
$button_parts[0] .= ' class="' . esc_attr( $classes ) . '"';
}
}
echo $button_parts[0]; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
do_action( 'frm_submit_button_action', $form, $form_action );
echo $button_parts[1]; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
}
/**
* @since 4.0
*/
public static function html_shortcodes() {
$codes = array(
'id' => array(
'label' => __( 'Field ID', 'formidable' ),
'class' => 'show_field_custom_html',
),
'key' => array(
'label' => __( 'Field Key', 'formidable' ),
'class' => 'show_field_custom_html',
),
'field_name' => array(
'label' => __( 'Field Name', 'formidable' ),
'class' => 'show_field_custom_html',
),
'description' => array(
'label' => __( 'Field Description', 'formidable' ),
'class' => 'show_field_custom_html',
),
'label_position' => array(
'label' => __( 'Label Position', 'formidable' ),
'class' => 'show_field_custom_html',
),
'required_label' => array(
'label' => __( 'Required Label', 'formidable' ),
'class' => 'show_field_custom_html',
),
'input' => array(
'label' => __( 'Input Field', 'formidable' ),
'class' => 'show_field_custom_html',
),
'input opt=1' => array(
'label' => __( 'Single Option', 'formidable' ),
'title' => __( 'Show a single radio or checkbox option by replacing 1 with the order of the option', 'formidable' ),
'class' => 'show_field_custom_html',
),
'input label=0' => array(
'label' => __( 'Hide Option Label', 'formidable' ),
'class' => 'show_field_custom_html',
),
'required_class' => array(
'label' => __( 'Required Class', 'formidable' ),
'title' => __( 'Add class name if field is required', 'formidable' ),
'class' => 'show_field_custom_html',
),
'error_class' => array(
'label' => __( 'Error Class', 'formidable' ),
'title' => __( 'Add class name if field has an error on form submit', 'formidable' ),
'class' => 'show_field_custom_html',
),
'form_name' => array(
'label' => __( 'Form Name', 'formidable' ),
'class' => 'show_before_html show_after_html',
),
'form_description' => array(
'label' => __( 'Form Description', 'formidable' ),
'class' => 'show_before_html show_after_html',
),
'form_key' => array(
'label' => __( 'Form Key', 'formidable' ),
'class' => 'show_before_html show_after_html',
),
'deletelink' => array(
'label' => __( 'Delete Entry Link', 'formidable' ),
'class' => 'show_before_html show_after_html',
),
'button_label' => array(
'label' => __( 'Button Label', 'formidable' ),
'class' => 'show_submit_html',
),
'button_action' => array(
'label' => __( 'Button Hook', 'formidable' ),
'class' => 'show_submit_html',
),
);
/**
* @since 4.0
*/
return apply_filters( 'frm_html_codes', $codes );
}
/**
* @since 4.0
* @param array $args
*/
public static function insert_opt_html( $args ) {
$class = isset( $args['class'] ) ? $args['class'] : '';
$fields = FrmField::all_field_selection();
$field = isset( $fields[ $args['type'] ] ) ? $fields[ $args['type'] ] : array();
self::prepare_field_type( $field );
if ( ! isset( $field['icon'] ) ) {
$field['icon'] = 'frmfont frm_pencil_icon';
}
$possible_email_field = FrmFieldFactory::field_has_property( $args['type'], 'holds_email_values' );
if ( $possible_email_field ) {
$class .= ' show_frm_not_email_to';
}
if ( 'url' === $args['type'] ) {
$class .= ' frm_insert_url';
}
?>
';
if ( $args['show_img'] && ! empty( $args['img'] ) ) {
echo ' . ')
';
} else {
$args['show_img'] = true;
}
echo wp_kses_post( $error );
echo '
';
}
}
public static function maybe_get_scroll_js( $id ) {
$offset = apply_filters( 'frm_scroll_offset', 4, array( 'form_id' => $id ) );
if ( $offset != - 1 ) {
self::get_scroll_js( $id );
}
}
public static function get_scroll_js( $form_id ) {
echo '';
}
/**
* @since 3.0
*/
public static function actions_dropdown( $atts ) {
if ( FrmAppHelper::is_admin_page( 'formidable' ) ) {
$status = $atts['status'];
$form_id = isset( $atts['id'] ) ? $atts['id'] : FrmAppHelper::get_param( 'id', 0, 'get', 'absint' );
$trash_link = self::delete_trash_info( $form_id, $status );
$links = self::get_action_links( $form_id, $status );
include( FrmAppHelper::plugin_path() . '/classes/views/frm-forms/actions-dropdown.php' );
}
}
/**
* @since 3.0
*/
public static function get_action_links( $form_id, $form ) {
if ( ! is_object( $form ) ) {
$form = FrmForm::getOne( $form_id );
}
$actions = array();
$trash_links = self::delete_trash_links( $form_id );
if ( 'trash' == $form->status ) {
$actions['restore'] = $trash_links['restore'];
if ( current_user_can( 'frm_delete_forms' ) ) {
$actions['trash'] = $trash_links['delete'];
}
} elseif ( current_user_can( 'frm_edit_forms' ) ) {
$duplicate_link = '?page=formidable&frm_action=duplicate&id=' . $form_id;
if ( $form->is_template ) {
$actions['frm_duplicate'] = array(
'url' => wp_nonce_url( $duplicate_link ),
'label' => __( 'Create Form from Template', 'formidable' ),
'icon' => 'frm_icon_font frm_clone_icon',
);
} else {
$actions['duplicate'] = array(
'url' => wp_nonce_url( $duplicate_link ),
'label' => __( 'Duplicate Form', 'formidable' ),
'icon' => 'frm_icon_font frm_clone_icon',
);
}
$actions['trash'] = self::delete_trash_info( $form_id, $form->status );
}
return $actions;
}
public static function edit_form_link( $data ) {
$form_id = self::get_form_id_from_data( $data );
if ( ! $form_id ) {
return '';
}
$label = self::edit_form_link_label( $data );
$link = '' . esc_html( $label ) . '';
return $link;
}
public static function edit_form_link_label( $data ) {
$name = self::get_form_name_from_data( $data );
if ( ! $name ) {
return __( '(no title)', 'formidable' );
}
return FrmAppHelper::truncate( $name, 40 );
}
/**
* @param mixed data
* @return int
*/
private static function get_form_id_from_data( $data ) {
if ( is_object( $data ) ) {
$form_id = $data->id;
} else {
$form_id = $data;
}
return $form_id;
}
/**
* @param mixed $data
* @return string
*/
private static function get_form_name_from_data( $data ) {
if ( is_object( $data ) ) {
$form_name = $data->name;
} else {
$form_id = $data;
$form_name = FrmForm::getName( $form_id );
}
return $form_name;
}
public static function delete_trash_link( $id, $status, $length = 'label' ) {
$link_details = self::delete_trash_info( $id, $status );
return self::format_link_html( $link_details, $length );
}
/**
* @since 3.0
*/
public static function format_link_html( $link_details, $length = 'label' ) {
$link = '';
if ( ! empty( $link_details ) ) {
$link = ' $value ) {
$link .= ' data-' . esc_attr( $data ) . '="' . esc_attr( $value ) . '"';
}
} elseif ( isset( $link_details['confirm'] ) ) {
$link .= ' onclick="return confirm(\'' . esc_attr( $link_details['confirm'] ) . '\')"';
}
$label = ( isset( $link_details[ $length ] ) ? $link_details[ $length ] : $link_details['label'] );
if ( $length == 'icon' && isset( $link_details[ $length ] ) ) {
$label = '';
$link .= ' aria-label="' . esc_attr( $link_details['label'] ) . '"';
}
$link .= '>' . $label . '';
}
return $link;
}
/**
* @since 3.0
*/
public static function delete_trash_info( $id, $status ) {
$labels = self::delete_trash_links( $id );
if ( 'trash' == $status ) {
$info = $labels['restore'];
} elseif ( current_user_can( 'frm_delete_forms' ) ) {
if ( EMPTY_TRASH_DAYS ) {
$info = $labels['trash'];
} else {
$info = $labels['delete'];
}
} else {
$info = array();
}
return $info;
}
/**
* @since 3.0
*/
private static function delete_trash_links( $id ) {
$current_page = FrmAppHelper::get_simple_request( array( 'param' => 'form_type' ) );
$base_url = '?page=formidable&form_type=' . $current_page . '&id=' . $id;
return array(
'restore' => array(
'label' => __( 'Restore from Trash', 'formidable' ),
'short' => __( 'Restore', 'formidable' ),
'url' => wp_nonce_url( $base_url . '&frm_action=untrash', 'untrash_form_' . absint( $id ) ),
),
'trash' => array(
'label' => __( 'Move Form to Trash', 'formidable' ),
'short' => __( 'Trash', 'formidable' ),
'url' => wp_nonce_url( $base_url . '&frm_action=trash', 'trash_form_' . absint( $id ) ),
'icon' => 'frm_icon_font frm_delete_icon',
'data' => array(
'frmverify' => __( 'Do you want to move this form to the trash?', 'formidable' ),
'frmverify-btn' => 'frm-button-red',
),
),
'delete' => array(
'label' => __( 'Delete Permanently', 'formidable' ),
'short' => __( 'Delete', 'formidable' ),
'url' => wp_nonce_url( $base_url . '&frm_action=destroy', 'destroy_form_' . absint( $id ) ),
'confirm' => __( 'Are you sure you want to delete this form and all its entries?', 'formidable' ),
'icon' => 'frm_icon_font frm_delete_icon',
'data' => array(
'frmverify' => __( 'This will permanently delete the form and all its entries. This is irreversible. Are you sure you want to continue?', 'formidable' ),
'frmverify-btn' => 'frm-button-red',
),
),
);
}
/**
* @since 3.0
*/
public static function css_classes() {
$classes = array(
'frm_total' => array(
'label' => __( 'Total', 'formidable' ),
'title' => __( 'Add this to a read-only field to display the text in bold without a border or background.', 'formidable' ),
),
'frm_total_big' => array(
'label' => __( 'Big Total', 'formidable' ),
'title' => __( 'Add this to a read-only field to display the text in large, bold text without a border or background.', 'formidable' ),
),
'frm_scroll_box' => array(
'label' => __( 'Scroll Box', 'formidable' ),
'title' => __( 'If you have many checkbox or radio button options, you may add this class to allow your user to easily scroll through the options. Or add a scrolling area around content in an HTML field.', 'formidable' ),
),
'frm_first' => array(
'label' => __( 'First', 'formidable' ),
'title' => __( 'Add this to the first field in each row along with a width. ie frm_first frm4', 'formidable' ),
),
'frm_alignright' => __( 'Right', 'formidable' ),
'frm_grid_first' => __( 'First Grid Row', 'formidable' ),
'frm_grid' => __( 'Even Grid Row', 'formidable' ),
'frm_grid_odd' => __( 'Odd Grid Row', 'formidable' ),
'frm_color_block' => array(
'label' => __( 'Color Block', 'formidable' ),
'title' => __( 'Add a background color to the field or section.', 'formidable' ),
),
'frm_capitalize' => array(
'label' => __( 'Capitalize', 'formidable' ),
'title' => __( 'Automatically capitalize the first letter in each word.', 'formidable' ),
),
);
return apply_filters( 'frm_layout_classes', $classes );
}
public static function grid_classes() {
return array(
'frm_half' => '1/2',
'frm_third' => '1/3',
'frm_two_thirds' => '2/3',
'frm_fourth' => '1/4',
'frm_three_fourths' => '3/4',
'frm_sixth' => '1/6',
'frm10' => '5/6',
'frm12' => '100%',
);
}
/**
* @since 3.0
*/
public static function style_class_label( $style, $class ) {
$label = '';
if ( empty( $style ) ) {
$label = $class;
} elseif ( ! is_array( $style ) ) {
$label = $style;
} elseif ( isset( $style['label'] ) ) {
$label = $style['label'];
}
return $label;
}
public static function status_nice_name( $status ) {
$nice_names = array(
'draft' => __( 'Draft', 'formidable' ),
'trash' => __( 'Trash', 'formidable' ),
'publish' => __( 'Published', 'formidable' ),
);
if ( ! in_array( $status, array_keys( $nice_names ) ) ) {
$status = 'publish';
}
$name = $nice_names[ $status ];
return $name;
}
/**
* @param array $categories
* @param array $atts {
* @type string $html 'span' or 'div'.
* @type boolean $bg Whether to add a bg color or not.
* }
*
* @return void
*/
public static function template_icon( $categories, $atts = array() ) {
$defaults = array(
'html' => 'span',
'bg' => false,
);
$atts = array_merge( $defaults, $atts );
$ignore = self::ignore_template_categories();
$categories = array_diff( $categories, $ignore );
$icons = array(
'WooCommerce' => array( 'woocommerce', 'var(--purple)' ),
'Post' => array( 'wordpress', 'rgb(0,160,210)' ),
'User Registration' => array( 'register', 'var(--pink)' ),
'Registration and Signup' => array( 'register', 'var(--pink)' ),
'PayPal' => array( 'paypal' ),
'Stripe' => array( 'credit_card', 'var(--green)' ),
'Twilio' => array( 'sms' ),
'Payment' => array( 'credit_card' ),
'Order Form' => array( 'product' ),
'Finance' => array( 'total' ),
'Health and Wellness' => array( 'heart', 'var(--pink)' ),
'Event Planning' => array( 'calendar', 'var(--orange)' ),
'Real Estate' => array( 'house' ),
'Nonprofit' => array( 'heart_solid' ),
'Calculator' => array( 'calculator', 'var(--purple)' ),
'Quiz' => array( 'percent' ),
'Registrations' => array( 'address_card' ),
'Customer Service' => array( 'users_solid' ),
'Education' => array( 'pencil' ),
'Marketing' => array( 'eye' ),
'Feedback' => array( 'smile' ),
'Business Operations' => array( 'case' ),
'Contact Form' => array( 'email' ),
'Conversational Forms' => array( 'chat_forms' ),
'Survey' => array( 'chat_forms', 'var(--orange)' ),
'Application' => array( 'align_right' ),
'Signature' => array( 'signature' ),
'' => array( 'align_right' ),
);
$icons[ __( 'My Templates', 'formidable' ) ] = array( 'user', 'var(--orange)' );
$icon = $icons[''];
if ( count( $categories ) === 1 ) {
$category = reset( $categories );
$icon = isset( $icons[ $category ] ) ? $icons[ $category ] : $icon;
} elseif ( ! empty( $categories ) ) {
foreach ( $icons as $cat => $icon ) {
if ( ! in_array( $cat, $categories ) ) {
unset( $icons[ $cat ] );
}
}
$icon = reset( $icons );
}
$bg = isset( $icon[1] ) ? $icon[1] : '';
if ( $atts['html'] === 'div' ) {
echo '