Files
amerike/wp-content/plugins/contact-form-7/admin/includes/dashboard.php
T
2026-10-06 18:51:23 -06:00

315 lines
8.1 KiB
PHP

<?php
if ( ! defined( 'ABSPATH' ) ) exit; // Exit if accessed directly
require_once ABSPATH . 'wp-admin/includes/dashboard.php';
/**
* Defines the core widgets for the Contact Form 7 Dashboard.
*/
function wpcf7_dashboard_widgets() {
return array(
'wpcf7_dashboard_right_now' => array(
'widget_name' => __( 'At a Glance', 'contact-form-7' ),
),
'wpcf7_dashboard_news' => array(
'widget_name' => __( 'News', 'contact-form-7' ),
),
'wpcf7_get_support' => array(
'widget_name' => __( 'Get Support', 'contact-form-7' ),
'context' => 'side',
),
'wpcf7_spam_protection' => array(
'widget_name' => __( 'Spam Protection', 'contact-form-7' ),
'context' => 'side',
),
'wpcf7_save_messages' => array(
'widget_name' => __( 'Save Messages', 'contact-form-7' ),
'context' => 'side',
),
);
}
/**
* Adds dashboard widgets to the Contact Form 7 Dashboard screen.
*/
function wpcf7_dashboard_setup() {
foreach ( wpcf7_dashboard_widgets() as $widget_id => $widget ) {
wp_add_dashboard_widget(
$widget_id,
$widget['widget_name'] ?? '',
$widget['callback'] ?? $widget_id,
$widget['control_callback'] ?? null,
$widget['callback_args'] ?? null,
$widget['context'] ?? 'normal',
$widget['priority'] ?? 'core'
);
}
do_action( 'wpcf7_dashboard_setup' );
}
/**
* Defines the "At a Glance" dashboard widget content.
*/
function wpcf7_dashboard_right_now() {
$formatter = new WPCF7_HTMLFormatter();
$formatter->append_start_tag( 'ul' );
$formatter->append_start_tag( 'li', array(
'class' => 'page-count',
) );
$formatter->append_start_tag( 'a', array(
'href' => menu_page_url( 'wpcf7', false ),
) );
WPCF7_ContactForm::find();
$count = WPCF7_ContactForm::count();
$formatter->append_preformatted(
esc_html( sprintf(
/* translators: %s: number of contact forms */
_n(
'%s Contact form',
'%s Contact forms',
$count,
'contact-form-7'
),
number_format_i18n( $count )
) )
);
if ( current_user_can( 'wpcf7_manage_integration' ) ) {
$integration = WPCF7_Integration::get_instance();
$services = array( 'sendinblue', 'turnstile', 'recaptcha', 'stripe' );
foreach ( $services as $service_name ) {
if ( $integration->service_exists( $service_name ) ) {
$service = $integration->get_service( $service_name );
if ( $service->is_active() ) {
$formatter->append_start_tag( 'li', array(
'class' => sprintf(
'active-integration %s',
$service_name
),
) );
$setup_page_link = add_query_arg(
array(
'service' => $service_name,
'action' => 'setup',
),
menu_page_url( 'wpcf7-integration', false )
);
$formatter->append_start_tag( 'a', array(
'href' => $setup_page_link,
) );
$formatter->append_preformatted(
sprintf(
/* translators: %s: service name */
__( '<strong>%s</strong> integration is active', 'contact-form-7' ),
$service->get_title()
)
);
}
}
}
}
if ( defined( 'FLAMINGO_VERSION' ) ) {
$formatter->append_start_tag( 'li', array(
'class' => 'flamingo',
) );
$formatter->append_start_tag( 'a', array(
'href' => menu_page_url( 'flamingo_inbound', false ),
) );
$formatter->append_preformatted(
sprintf(
/* translators: %s: Flamingo version */
__( '<strong>Flamingo</strong> (version %s) is active', 'contact-form-7' ),
FLAMINGO_VERSION
)
);
}
$formatter->end_tag( 'ul' );
$formatter->append_start_tag( 'p' );
$formatter->append_preformatted(
esc_html( sprintf(
/* translators: %s: Contact Form 7 version string */
__( 'Contact Form 7 version %s is running.', 'contact-form-7' ),
WPCF7_VERSION
) )
);
$formatter->print();
}
/**
* Defines the "News" dashboard widget content.
*/
function wpcf7_dashboard_news() {
echo '<div class="cf7com-news hide-if-no-js">';
wpcf7_dashboard_cf7com_news();
echo '</div>';
}
/**
* Retrieves the news feed from the contactform7.com site.
*/
function wpcf7_dashboard_cf7com_news() {
wp_dashboard_cached_rss_widget(
'wpcf7_dashboard_cf7com_news',
'wp_dashboard_primary_output',
array(
'news' => array(
'link' => 'https://contactform7.com/',
'url' => 'https://contactform7.com/feed/',
'title' => __( 'Contact Form 7 official site', 'contact-form-7' ),
'items' => 6,
'show_summary' => 0,
'show_author' => 0,
'show_date' => 1,
),
)
);
}
/**
* Defines the "Get Support" dashboard widget content.
*/
function wpcf7_get_support() {
$formatter = new WPCF7_HTMLFormatter();
$formatter->append_start_tag( 'p' );
$formatter->append_preformatted(
__( 'Do you need help? These support channels are available:', 'contact-form-7' )
);
$formatter->append_start_tag( 'ul' );
$formatter->append_start_tag( 'li', array(
'class' => 'public',
) );
$formatter->append_start_tag( 'a', array(
'href' => 'https://wordpress.org/support/plugin/contact-form-7/',
) );
$formatter->append_preformatted(
__( 'Public support forum on WordPress.org', 'contact-form-7' )
);
$formatter->append_start_tag( 'li', array(
'class' => 'private',
) );
$formatter->append_start_tag( 'a', array(
'href' => 'https://contactform7.com/custom-development/',
) );
$formatter->append_preformatted(
__( 'Private support by Codeable experts', 'contact-form-7' )
);
$formatter->end_tag( 'ul' );
$formatter->append_start_tag( 'p' );
$formatter->append_preformatted(
sprintf(
/* translators: 1: URL to the docs page, 2: URL to the FAQ page */
__( 'Or, consult the <a href="%1$s">docs</a> and <a href="%2$s">FAQ</a>.', 'contact-form-7' ),
'https://contactform7.com/docs/',
'https://contactform7.com/faq/'
)
);
$formatter->print();
}
/**
* Defines the "Spam Protection" dashboard widget content.
*/
function wpcf7_spam_protection() {
$formatter = new WPCF7_HTMLFormatter();
$formatter->append_start_tag( 'p' );
$formatter->append_preformatted(
__( 'Spammers target everything. Your contact forms are not an exception.', 'contact-form-7' )
);
$formatter->append_start_tag( 'p' );
$formatter->append_preformatted(
sprintf(
/* translators: 1: URL to the Turnstile doc page, 2: URL to the Akismet doc page */
__( 'To provide effective protection, Contact Form 7 recommends using <a href="%1$s"><strong>Turnstile</strong></a> (good at blocking bots) and <a href="%2$s"><strong>Akismet</strong></a> (good at blocking human spammers) together.', 'contact-form-7' ),
'https://contactform7.com/turnstile-integration/',
'https://contactform7.com/spam-filtering-with-akismet/'
)
);
$formatter->append_start_tag( 'p' );
$formatter->append_preformatted(
sprintf(
/* translators: %s: URL to the Disallowed list doc page */
__( 'You can also block submissions that contain specific keywords or come from specific IP addresses (<a href="%s"><strong>Disallowed list</strong></a>).', 'contact-form-7' ),
'https://contactform7.com/comment-blacklist/'
)
);
$formatter->print();
}
/**
* Defines the "Save Messages" dashboard widget content.
*/
function wpcf7_save_messages() {
$formatter = new WPCF7_HTMLFormatter();
$formatter->append_start_tag( 'p' );
$formatter->append_preformatted(
sprintf(
/* translators: %s: URL to the Flamingo doc page */
__( 'Contact Form 7 itself doesn&#8217;t have a feature to store submitted messages; therefore, there is always a risk of losing important messages. Contact Form 7 recommends installing a separate plugin called <a href="%s"><strong>Flamingo</strong></a>, which is dedicated to storing messages in the database.', 'contact-form-7' ),
'https://contactform7.com/save-submitted-messages-with-flamingo/'
)
);
$formatter->append_start_tag( 'p' );
$formatter->append_preformatted(
sprintf(
/* translators: %s: URL to the Brevo integration doc page */
__( 'If you use contact forms for customer relationship management, consider activating the <a href="%s"><strong>Brevo</strong></a> integration. With the integration, Contact Form 7 can safely connect to the leading CRM platform in Europe, while protecting user privacy.', 'contact-form-7' ),
'https://contactform7.com/sendinblue-integration/'
)
);
$formatter->print();
}