includes();
// Init admin pages.
add_action( 'admin_menu', array( $this, 'add_dashboard_page' ) );
if ( current_user_can( 'manage_options' ) ) {
add_action( 'admin_notices', array( $this, 'show_stripe_updated_notice' ) );
add_action( 'admin_notices', array( $this, 'show_rating_notice' ) );
add_action( 'admin_notices', array( $this, 'show_pro_available_notice' ) );
// Show Promote free plan notice only for Free version, for admins and if WPMU DEV Dashboard is not activated.
if ( ! FORMINATOR_PRO && ! class_exists( 'WPMUDEV_Dashboard' )
// The notice was already dismissed.
&& ! self::was_notification_dismissed( 'forminator_promote_free_plan' )
// Remind me later was clicked.
&& ! self::maybe_remind_later()
) {
add_action( 'admin_notices', array( $this, 'promote_free_plan' ) );
add_action( 'admin_enqueue_scripts', array( $this, 'promote_free_plan_scripts' ) );
}
add_action( 'admin_notices', array( $this, 'check_stripe_addon_version' ) );
add_action( 'admin_notices', array( $this, 'show_cf7_importer_notice' ) );
if ( ! forminator_addons_disabled() ) {
add_action( 'admin_notices', array( $this, 'show_addons_update_notice' ) );
}
add_action( 'admin_notices', array( $this, 'set_encryption_key_notice' ) );
add_action( 'admin_enqueue_scripts', array( $this, 'deactivation_scripts' ) );
add_action( 'admin_footer-plugins.php', array( $this, 'load_deactivation_survey_modal' ) );
}
// Add plugin action links.
add_filter( 'plugin_action_links_' . FORMINATOR_PLUGIN_BASENAME, array( $this, 'add_plugin_action_links' ) );
if ( forminator_is_networkwide() ) {
add_filter(
'network_admin_plugin_action_links_' . FORMINATOR_PLUGIN_BASENAME,
array(
$this,
'add_plugin_action_links',
)
);
}
// Add links next to plugin details.
add_filter( 'plugin_row_meta', array( $this, 'plugin_row_meta' ), 10, 3 );
// Update permissions when user profile is updated.
add_action( 'profile_update', array( $this, 'maybe_update_permissions' ), 10, 1 );
// Clear pages cache.
add_action( 'save_post', array( $this, 'clear_pages_cache' ) );
add_action( 'delete_post', array( $this, 'clear_pages_cache' ) );
add_action( 'trash_post', array( $this, 'clear_pages_cache' ) );
add_action( 'untrash_post', array( $this, 'clear_pages_cache' ) );
// Init Admin AJAX class.
new Forminator_Admin_AJAX();
/**
* Triggered when Admin is loaded
*/
do_action( 'forminator_admin_loaded' );
}
/**
* Init deactivation scripts
*
* @return void
*/
public function deactivation_scripts() {
$screen = get_current_screen();
if ( 'plugins' !== $screen->id && 'plugins-network' !== $screen->id ) {
return;
}
// Load admin scripts.
wp_register_script(
'forminator-admin',
forminator_plugin_url() . 'requirejs/main.js',
array(
'backbone',
'underscore',
'jquery',
),
FORMINATOR_VERSION,
true
);
// Load jquery ui.
forminator_admin_jquery_ui_init();
// Load shared-ui scripts.
forminator_sui_scripts();
// Load admin styles.
forminator_admin_enqueue_styles();
$forminator_data = new Forminator_Admin_Data();
$forminator_l10n = new Forminator_Admin_L10n();
$data = $forminator_data->get_options_data();
$l10n = $forminator_l10n->get_l10n_strings();
wp_localize_script( 'forminator-admin', 'forminatorData', $data );
wp_localize_script( 'forminator-admin', 'forminatorl10n', $l10n );
wp_enqueue_script( 'forminator-admin' );
}
/**
* Load Deactivation Survey Modal
*
* @return void
*/
public function load_deactivation_survey_modal() {
$file_name = 'deactivation-survey-modal.php';
$file_path = forminator_plugin_dir() . 'admin/views/plugins/' . $file_name;
require_once $file_path;
}
/**
* Include required files
*
* @since 1.0
*/
private function includes() {
// Admin pages.
include_once forminator_plugin_dir() . 'admin/pages/dashboard-page.php';
include_once forminator_plugin_dir() . 'admin/pages/entries-page.php';
include_once forminator_plugin_dir() . 'admin/pages/integrations-page.php';
include_once forminator_plugin_dir() . 'admin/pages/settings-page.php';
include_once forminator_plugin_dir() . 'admin/pages/addons-page.php';
include_once forminator_plugin_dir() . 'admin/pages/reports-page.php';
include_once forminator_plugin_dir() . 'admin/pages/templates-page.php';
// Admin AJAX.
include_once forminator_plugin_dir() . 'admin/classes/class-admin-ajax.php';
// Admin Data.
include_once forminator_plugin_dir() . 'admin/classes/class-admin-data.php';
// Admin l10n.
include_once forminator_plugin_dir() . 'admin/classes/class-admin-l10n.php';
if ( forminator_is_import_plugin_enabled( 'cf7' ) ) {
// CF7 Import.
include_once forminator_plugin_dir() . 'admin/classes/thirdparty-importers/class-importer-cf7.php';
}
if ( forminator_is_import_plugin_enabled( 'ninjaforms' ) ) {
// Ninjaforms Import.
include_once forminator_plugin_dir() . 'admin/classes/thirdparty-importers/class-importer-ninja.php';
}
if ( forminator_is_import_plugin_enabled( 'gravityforms' ) ) {
// Gravityforms CF7 Import.
include_once forminator_plugin_dir() . 'admin/classes/thirdparty-importers/class-importer-gravity.php';
}
// Admin Addons page.
include_once forminator_plugin_dir() . 'admin/classes/class-addons-page.php';
// Admin report page.
include_once forminator_plugin_dir() . 'admin/classes/class-reports-page.php';
}
/**
* Initialize Dashboard page
*
* @since 1.0
*/
public function add_dashboard_page() {
$title = esc_html__( 'Forminator', 'forminator' );
$this->pages['forminator'] = new Forminator_Dashboard_Page( 'forminator', 'dashboard', $title, $title, false, false );
$this->pages['forminator-dashboard'] = new Forminator_Dashboard_Page( 'forminator', 'dashboard', esc_html__( 'Forminator Dashboard', 'forminator' ), esc_html__( 'Dashboard', 'forminator' ), 'forminator' );
}
/**
* Add Integrations page
*
* @since 1.1
*/
public function add_integrations_page() {
add_action( 'admin_menu', array( $this, 'init_integrations_page' ) );
}
/**
* Initialize Integrations page
*
* @since 1.1
*/
public function init_integrations_page() {
$this->pages['forminator-integrations'] = new Forminator_Integrations_Page(
'forminator-integrations',
'integrations',
esc_html__( 'Integrations', 'forminator' ),
esc_html__( 'Integrations', 'forminator' ),
'forminator'
);
// TODO: remove this after converted to JS.
$addons = Forminator_Integration_Loader::get_instance()->get_addons()->to_array();
foreach ( $addons as $slug => $addon_array ) {
$addon_class = forminator_get_addon( $slug );
if ( $addon_class && is_callable( array( $addon_class, 'admin_hook_html_version' ) ) ) {
call_user_func( array( $addon_class, 'admin_hook_html_version' ) );
}
}
}
/**
* Add Settings page
*
* @since 1.0
*/
public function add_settings_page() {
add_action( 'admin_menu', array( $this, 'init_settings_page' ) );
}
/**
* Initialize Settings page
*
* @since 1.0
*/
public function init_settings_page() {
$this->pages['forminator-settings'] = new Forminator_Settings_Page( 'forminator-settings', 'settings', esc_html__( 'Global Settings', 'forminator' ), esc_html__( 'Settings', 'forminator' ), 'forminator' );
}
/**
* Add Templates page
*
* @since 1.0
*/
public function add_templates_page() {
add_action( 'admin_menu', array( $this, 'init_templates_page' ) );
}
/**
* Initialize templates page
*
* @since 1.0
*/
public function init_templates_page() {
$section_name = esc_html__( 'Templates', 'forminator' );
$this->pages['forminator-templates'] = new Forminator_Templates_Page( 'forminator-templates', 'templates', $section_name, $section_name, 'forminator' );
}
/**
* Add Entries page
*
* @since 1.0.5
*/
public function add_entries_page() {
add_action( 'admin_menu', array( $this, 'init_entries_page' ) );
}
/**
* Initialize Entries page
*
* @since 1.0.5
*/
public function init_entries_page() {
$this->pages['forminator-entries'] = new Forminator_Entries_Page(
'forminator-entries',
'common/entries',
esc_html__( 'Forminator Submissions', 'forminator' ),
esc_html__( 'Submissions', 'forminator' ),
'forminator'
);
}
/**
* Add Forminator Pro page
*
* @since 1.0
*/
public function add_upgrade_page() {
add_action( 'admin_menu', array( $this, 'init_upgrade_page' ), 20 );
}
/**
* Initialize Settings page
*
* @since 1.0
*/
public function init_upgrade_page() {
add_submenu_page(
'forminator',
esc_html__( 'Get Forminator Pro', 'forminator' ),
esc_html__( 'Get Forminator Pro', 'forminator' ),
forminator_get_permission( 'forminator-upgrade' ),
'https://wpmudev.com/project/forminator-pro/?utm_source=forminator&utm_medium=plugin&utm_campaign=forminator_submenu_upsell'
);
}
/**
* Add Add-ons page
*
* @since 1.15
*/
public function add_addons_page() {
add_action( 'admin_menu', array( $this, 'init_addons_page' ) );
}
/**
* Initialize Add-ons page
*
* @since 1.15
*/
public function init_addons_page() {
$this->pages['forminator-addons'] = new Forminator_Addons_Page(
'forminator-addons',
'addons',
esc_html__( 'Forminator Add-ons', 'forminator' ),
esc_html__( 'Add-ons', 'forminator' ),
'forminator'
);
}
/**
* Add Reports page
*
* @since 1.18.0
*/
public function add_reports_page() {
add_action( 'admin_menu', array( $this, 'init_reports_page' ) );
}
/**
* Initialize Reports page
*
* @since 1.18.0
*/
public function init_reports_page() {
$this->pages['forminator-reports'] = new Forminator_Reports_Page( 'forminator-reports', 'common/reports', esc_html__( 'Reports', 'forminator' ), esc_html__( 'Reports', 'forminator' ), 'forminator' );
}
/**
* Check if we have any old Stripe form
*
* @return bool
* @since 1.9
*/
public function has_old_stripe_forms() {
$forms = Forminator_Form_Model::model()->get_models_by_field_and_version( 'stripe-1', '1.9-alpha.1' );
if ( count( $forms ) > 0 ) {
return true;
}
return false;
}
/**
* Displays an admin notice when the user is an active member and doesn't have Forminator Pro installed
* Shown in forminator pages. Per user notification.
*/
public function show_pro_available_notice() {
if ( ( isset( $_GET['page'] ) && 'forminator' !== substr( sanitize_text_field( wp_unslash( $_GET['page'] ) ), 0, 10 ) ) || FORMINATOR_PRO ) { // phpcs:ignore WordPress.Security.NonceVerification.Recommended
return;
}
// The notice was already dismissed.
if ( self::was_notification_dismissed( 'forminator_pro_is_available' ) ) {
return;
}
// Show the notice only to users who can do something about this and who are members.
if ( ! self::user_can_update_plugins() || ! forminator_can_install_pro() ) {
return;
}
$url = add_query_arg(
array( 'page' => 'wpmudev-plugins' ),
network_admin_url( 'admin.php' )
) . '#pid=2097296';
$link = '' . esc_html__( 'Upgrade', 'forminator' ) . '';
$username = forminator_get_current_username();
$name = ! empty( $username ) ? $username : esc_html__( 'Hey', 'forminator' );
$message = '';
/* translators: user's name */
$message .= sprintf( esc_html__( '%s, it appears you have an active WPMU DEV membership but haven\'t upgraded Forminator to the pro version. You won\'t lose any settings upgrading, go for it!', 'forminator' ), $name );
$message .= '
';
$message .= '' . $link . '
';
echo '';
echo wp_kses_post( $message );
echo '
';
}
/**
* Enqueue scripts for Promote Free Plan notice
*/
public function promote_free_plan_scripts() {
// Show the notice only on WP Dashboard page.
$screen = get_current_screen();
if ( 'dashboard' !== $screen->id ) {
return;
}
$dashboard_object = $this->pages['forminator-dashboard'];
$dashboard_object->enqueue_scripts( '' );
}
/**
* Displays Promote Free Plan notice
*/
public function promote_free_plan() {
// Show the notice only on WP Dashboard page.
$screen = get_current_screen();
if ( 'dashboard' !== $screen->id || Forminator_Hub_Connector::hub_connector_connected() ) {
return;
}
$button_1 = ''
. esc_html__( 'Connect & Start Using Pro Templates', 'forminator' )
. '';
$remind = '' . esc_html__( 'Remind me later', 'forminator' ) . '';
$message = '';
$message .= esc_html__( 'Pro Form Templates—Now Free for Everyone!', 'forminator' );
$message .= '
';
$message .= '';
$message .= esc_html__( 'Build forms faster with professionally designed templates—now free in the Forminator plugin.', 'forminator' );
$message .= '
';
$message .= '';
$message .= esc_html__( 'Connect your site to access them instantly and unlock WPMU DEV’s full suite of tools—trusted by 50K+ developers.', 'forminator' );
$message .= ' ' . esc_html__( 'All completely free.', 'forminator' ) . '';
$message .= '
';
$message .= '' . $button_1 . ' ' . $remind . '
';
echo '';
echo wp_kses_post( $message );
echo '
';
$dashboard_object = $this->pages['forminator-dashboard'];
echo '';
echo '
';
$dashboard_object->template( 'dashboard/promote-free-plan' );
echo '
';
echo '
';
/* translators: 1. Forminator version. 2. Min Stripe addon version. */
$message .= sprintf( esc_html__( 'We\'ve noticed you have updated to Forminator Pro version %1$s. Please ensure you also update your Forminator Stripe Subscriptions Add-on to version %2$s or higher to ensure compatibility with the new submissions processes.', 'forminator' ), FORMINATOR_VERSION, $min_stripe_addon_version );
$message .= '
';
echo '';
echo wp_kses_post( $message );
echo '
';
}
/**
* Check if the given notification was dismissed.
*
* @param string $notification_name Notification slug.
*
* @return bool
*/
public static function was_notification_dismissed( $notification_name ) {
$dismissed = get_user_meta( get_current_user_id(), 'frmt_dismissed_messages', true );
return ( is_array( $dismissed ) && in_array( $notification_name, $dismissed, true ) );
}
/**
* Return true if Remind me later was clicked
*
* @return bool
*/
private static function maybe_remind_later() {
$option = get_transient( 'forminator_free_plan_remind_later_' . get_current_user_id() );
return (bool) $option;
}
/**
* Check if the current user is able to update plugins
*
* @return bool
*/
public static function user_can_update_plugins() {
$cap = is_multisite() ? 'manage_network_plugins' : 'update_plugins';
return current_user_can( $cap );
}
/**
* Show CF7 importer notice
*
* @since 1.11
*/
public function show_cf7_importer_notice() {
$notice_dismissed = get_option( 'forminator_cf7_notice_dismissed', false );
if ( $notice_dismissed ) {
return;
}
if ( ! forminator_is_import_plugin_enabled( 'cf7' ) ) {
return;
}
?>
has_old_stripe_forms() ) {
return;
}
?>
has_active_integrations() ) ) {
return;
}
$news = __( 'Forminator encrypts and securely stores all payment and integration keys.', 'forminator' );
$see_doc = forminator_is_show_documentation_link() ? sprintf(
/* Translators: 1. Opening tag with link to documentation, 2. Closing tag. */
esc_html__( 'For more information, %1$ssee our documentation%2$s.', 'forminator' ),
'',
''
) : '';
?>
= $published_modules ) && ! $publish_later ) || ( 10 < $published_modules && ! $publish_later_dismiss ) ) {
$milestone = ( 10 >= $published_modules ) ? 5 : 10;
$data_type = ( 10 >= $published_modules ) ? 'five_modules' : 'ten_modules';
?>
strtotime( '+7 days', $install_date ) && ! $publish_later && ! $publish_later_dismiss && ! $days_later_dismiss ) {
?>
' . esc_html__( 'Dashboard', 'forminator' ) . '';
}
// Documentation link.
$action_links['docs'] = '' . esc_html__( 'Docs', 'forminator' ) . '';
// Check if the current logged-in member has access Forminator Pro.
$can_install_pro = forminator_can_install_pro();
$membership_type = forminator_get_wpmudev_membership();
// Upgrade or Renew links.
if ( ! FORMINATOR_PRO ) {
if ( $can_install_pro ) {
$action_links['upgrade'] = '' . esc_html__( 'Upgrade', 'forminator' ) . '';
} else {
$action_links['renew'] = '' . esc_html__( 'Get Forminator Pro', 'forminator' ) . '';
}
} elseif ( in_array( $membership_type, array( 'expired', 'free', 'paused', '' ), true ) && ! $can_install_pro ) {
$action_links['renew'] = '' . esc_html__( 'Renew Membership', 'forminator' ) . '';
}
return array_merge( $action_links, $links );
}
/**
* Show row meta on the plugin screen.
*
* @param mixed $links Plugin Row Meta.
* @param mixed $file Plugin Base file.
* @param array $plugin_data Plugin data.
*
* @return array
* @since 1.13
*/
public function plugin_row_meta( $links, $file, $plugin_data ) {
if ( FORMINATOR_PLUGIN_BASENAME === $file ) {
// Show network meta links only when activated network wide.
if ( is_network_admin() && ! forminator_is_networkwide() ) {
return $links;
}
// Change AuthorURI link.
if ( isset( $links[1] ) ) {
$author_uri = 'https://profiles.wordpress.org/wpmudev/';
$author_uri = sprintf(
'%s',
$author_uri,
esc_html__( 'WPMU DEV', 'forminator' )
);
$links[1] = /* translators: %s: Authorise url. */ sprintf( esc_html__( 'By %s', 'forminator' ), $author_uri );
}
if ( ! FORMINATOR_PRO ) {
// Change AuthorURI link.
if ( isset( $links[2] ) && false === strpos( $links[2], 'target="_blank"' ) ) {
if ( ! isset( $plugin_data['slug'] ) && $plugin_data['Name'] ) {
$links[2] = sprintf(
'%s',
esc_url(
network_admin_url(
'plugin-install.php?tab=plugin-information&plugin=forminator' .
'&TB_iframe=true&width=600&height=550'
)
),
/* translators: %s: Plugin name. */
sprintf( esc_html__( 'More information about %s', 'forminator' ), $plugin_data['Name'] ),
esc_attr( $plugin_data['Name'] ),
esc_html__( 'View details', 'forminator' )
);
} else {
$links[2] = str_replace( 'href=', 'target="_blank" href=', $links[2] );
}
}
$row_meta['rate'] = '' . esc_html__( 'Rate Forminator', 'forminator' ) . '';
$row_meta['support'] = '' . esc_html__( 'Support', 'forminator' ) . '';
}
$row_meta['roadmap'] = '' . esc_html__( 'Roadmap', 'forminator' ) . '';
return array_merge( $links, $row_meta );
}
return $links;
}
/**
* Show addons update notice
*/
public function show_addons_update_notice() {
}
/**
* Show hosting promotion banner
*
* To test:
* update_option( 'forminator_free_install_date', strtotime( '-31 days', current_time( 'timestamp' ) ) );
* update_option( 'forminator_hosting_banner_later', strtotime( '-8 days', current_time( 'timestamp' ) ) );
*/
public function show_hosting_notice() {
if ( ! current_user_can( 'manage_options' ) || forminator_is_site_connected_to_hub() || FORMINATOR_PRO ) {
return;
}
// Check if the page is a forminator page but not edit module pages.
$page = Forminator_Core::sanitize_text_field( 'page' );
preg_match( '/^(forminator-)([a-z]+)(-wizard)/', $page, $page_slug );
if ( isset( $page_slug[0] ) || 0 !== strpos( $page, 'forminator' ) ) {
return;
}
// Check if 30days has passed since install date. I shall return...
$install_date = get_site_option( 'forminator_free_install_date', false );
if ( $install_date && current_time( 'timestamp' ) < strtotime( '+30 days', $install_date ) ) { // phpcs:ignore WordPress.DateTime.CurrentTimeTimestamp.Requested -- We are using the current timestamp based on the site's timezone.
return;
}
$notice_dismissed = get_option( 'forminator_hosting_banner_dismiss', false );
if ( $notice_dismissed ) {
return;
}
$notice_later = get_option( 'forminator_hosting_banner_later', false );
if ( $notice_later && current_time( 'timestamp' ) < strtotime( '+7 days', $notice_later ) ) { // phpcs:ignore WordPress.DateTime.CurrentTimeTimestamp.Requested -- We are using the current timestamp based on the site's timezone.
return;
}
wp_enqueue_script(
'forminator-hosting-banner',
forminator_plugin_url() . 'build/hosting.js',
array(
'jquery',
'react',
'react-dom',
'wp-element',
),
FORMINATOR_VERSION,
true
);
?>
$permission ) {
/**
* For specific users.
* - Add caps to the users
* - Check each permission for get_avatar then retrieve it.
*/
if ( 'specific' === $permission['permission_type'] ) {
foreach ( $permission['specific_user'] as $user_index => $user_id ) {
$user = get_user_by( 'ID', $user_id );
if ( false !== $user ) {
// Set user info.
$permissions[ $key ]['user_info'][ $user_id ]['name'] = $user->display_name;
$permissions[ $key ]['user_info'][ $user_id ]['email'] = $user->user_email;
// We only need avatar for first user.
if ( 0 === $user_index ) {
$permissions[ $key ]['avatar'] = get_avatar_url( $user->user_email, array( 'size' => 30 ) );
}
}
}
/**
* For roles.
* - Add caps to users under these roles.
*/
} else {
if ( empty( $permission['exclude_users'] ) ) {
continue;
}
// Set user info for excluded users.
foreach ( $permission['exclude_users'] as $user_id ) {
$user = get_user_by( 'ID', $user_id );
if ( false !== $user ) {
$permissions[ $key ]['user_info'][ $user_id ]['name'] = $user->display_name;
$permissions[ $key ]['user_info'][ $user_id ]['email'] = $user->user_email;
}
}
}
}
update_option( 'forminator_permissions', $permissions );
}
/**
* Get error notice
*
* @param string $error Error message. It should be already escaped.
* @return string
*/
public static function get_red_notice( string $error ): string {
return static::get_notice( 'error', $error );
}
/**
* Get success notice
*
* @param string $message Success message. It should be already escaped.
* @return string
*/
public static function get_green_notice( string $message ): string {
return static::get_notice( 'green', $message );
}
/**
* Get SUI notice
*
* @param string $type Notice type.
* @param string $message Message. It should be already escaped.
* @return string
*/
public static function get_notice( string $type, string $message ): string {
$notice_class = 'green' === $type ? 'sui-notice-green' : 'sui-notice-red';
$icon_class = 'green' === $type ? 'sui-icon-check-tick' : 'sui-icon-info';
return '';
}
/**
* Clear pages cache
*
* @param int|null $post_id Post ID.
*/
public static function clear_pages_cache( ?int $post_id = null ) {
if ( ! is_null( $post_id ) && 'page' === get_post_type( $post_id ) ) {
wp_cache_delete( 'forminator_cached_pages', 'forminator-cache' );
}
}
}