* WPForms admin bar menu.
if ( ! $this->has_access() ) {
public function hooks() {
add_action( 'admin_enqueue_scripts', [ $this, 'enqueue_css' ] );
add_action( 'wp_enqueue_scripts', [ $this, 'enqueue_css' ] );
add_action( 'wp_enqueue_scripts', [ $this, 'enqueue_js' ] );
add_action( 'admin_bar_menu', [ $this, 'register' ], 999 );
add_action( 'wpforms_wp_footer_end', [ $this, 'menu_forms_data_html' ] );
* Determine whether the current user has access to see the admin bar menu.
public function has_access(): bool {
is_admin_bar_showing() &&
wpforms_current_user_can() &&
! wpforms_setting( 'hide-admin-bar', false )
* Filters whether the current user has access to see the admin bar menu.
* @param bool $access Whether the current user has access to see the admin bar menu.
return (bool) apply_filters( 'wpforms_admin_adminbarmenu_has_access', $access ); // phpcs:ignore WPForms.PHP.ValidateHooks.InvalidHookName
* Determine whether new notifications are available.
public function has_notifications() {
return wpforms()->obj( 'notifications' )->get_count();
public function enqueue_css() {
$min = wpforms_get_min_suffix();
WPFORMS_PLUGIN_URL . "assets/css/admin-bar{$min}.css",
// Apply WordPress pre/post 5.7 accent color, only when admin bar is displayed on the frontend or we're
// inside the Form Builder - it does not load some WP core admin styles, including themes.
if ( wpforms_is_admin_page( 'builder' ) || ! is_admin() ) {
'#wpadminbar .wpforms-menu-notification-counter, #wpadminbar .wpforms-menu-notification-indicator {
background-color: %s !important;
color: #ffffff !important;
version_compare( get_bloginfo( 'version' ), '5.7', '<' ) ? '#ca4a1f' : '#d63638'
* Enqueue JavaScript files.
public function enqueue_js() {
function wpforms_admin_bar_menu_init() {
var template = document.getElementById( 'tmpl-wpforms-admin-menubar-data' ),
notifications = document.getElementById( 'wp-admin-bar-wpforms-notifications' );
var menu = document.getElementById( 'wp-admin-bar-wpforms-menu-default' );
menu.insertAdjacentHTML( 'afterBegin', template.innerHTML );
notifications.insertAdjacentHTML( 'afterend', template.innerHTML );
document.addEventListener( 'DOMContentLoaded', wpforms_admin_bar_menu_init );
* Register and render admin bar menu items.
* @param WP_Admin_Bar $wp_admin_bar WordPress Admin Bar object.
public function register( WP_Admin_Bar $wp_admin_bar ) {
$items = (array) apply_filters(
'wpforms_admin_adminbarmenu_register',
foreach ( $items as $item ) {
$this->{ $item }( $wp_admin_bar );
do_action( "wpforms_admin_adminbarmenu_register_{$item}_after", $wp_admin_bar );
$this->register_settings_submenu( $wp_admin_bar );
$this->register_tools_submenu( $wp_admin_bar );
* Register Settings submenu.
* @param WP_Admin_Bar $wp_admin_bar WordPress Admin Bar object.
private function register_settings_submenu( WP_Admin_Bar $wp_admin_bar ) {
* Filters the Settings submenu items.
* @param array $items Array of submenu items.
* @param WP_Admin_Bar $wp_admin_bar WordPress Admin Bar object.
$items = (array) apply_filters(
'wpforms_admin_bar_menu_register_settings_submenu',
'wpforms-general-settings' => [
'title' => __( 'General', 'wpforms-lite' ),
'path' => 'admin.php?page=wpforms-settings&view=general',
'wpforms-email-settings' => [
'title' => __( 'Email', 'wpforms-lite' ),
'path' => 'admin.php?page=wpforms-settings&view=email',
'wpforms-captcha-settings' => [
'title' => __( 'CAPTCHA', 'wpforms-lite' ),
'path' => 'admin.php?page=wpforms-settings&view=captcha',
'wpforms-validation-settings' => [
'title' => __( 'Validation', 'wpforms-lite' ),
'path' => 'admin.php?page=wpforms-settings&view=validation',
'wpforms-payments-settings' => [
'title' => __( 'Payments', 'wpforms-lite' ),
'path' => 'admin.php?page=wpforms-settings&view=payments',
'wpforms-integrations-settings' => [
'title' => __( 'Integrations', 'wpforms-lite' ),
'path' => 'admin.php?page=wpforms-settings&view=integrations',
'wpforms-geolocation-settings' => [
'title' => __( 'Geolocation', 'wpforms-lite' ),
'path' => 'admin.php?page=wpforms-settings&view=geolocation',
'wpforms-access-settings' => [
'title' => __( 'Access Control', 'wpforms-lite' ),
'path' => 'admin.php?page=wpforms-settings&view=access',
'wpforms-misc-settings' => [
'title' => __( 'Misc', 'wpforms-lite' ),
'path' => 'admin.php?page=wpforms-settings&view=misc',
foreach ( $items as $item_id => $args ) {
'parent' => 'wpforms-settings',
'id' => sanitize_key( $item_id ),
'title' => esc_html( $args['title'] ),
'href' => admin_url( $args['path'] ),
* Fires after the Settings submenu item is registered.
* @param WP_Admin_Bar $wp_admin_bar WordPress Admin Bar object.
do_action( "wpforms_admin_bar_menu_register_settings_submenu_{$item_id}_after", $wp_admin_bar );
* Register Tools submenu.
* @param WP_Admin_Bar $wp_admin_bar WordPress Admin Bar object.
private function register_tools_submenu( WP_Admin_Bar $wp_admin_bar ) {
* Filters the Tools submenu items.
* @param array $items Array of submenu items.
* @param WP_Admin_Bar $wp_admin_bar WordPress Admin Bar object.
$items = (array) apply_filters(
'wpforms_admin_bar_menu_register_tools_submenu',
'wpforms-tools-import' => [
'title' => esc_html__( 'Import', 'wpforms-lite' ),
'path' => 'admin.php?page=wpforms-tools&view=import',
'wpforms-tools-export' => [
'title' => esc_html__( 'Export', 'wpforms-lite' ),
'path' => 'admin.php?page=wpforms-tools&view=export',
'wpforms-tools-entry-automation' => [
'title' => esc_html__( 'Entry Automation', 'wpforms-lite' ),
'path' => 'admin.php?page=wpforms-tools&view=entry-automation',
'wpforms-tools-system' => [
'title' => esc_html__( 'System Info', 'wpforms-lite' ),
'path' => 'admin.php?page=wpforms-tools&view=system',
'wpforms-tools-action-scheduler' => [
'title' => esc_html__( 'Scheduled Actions', 'wpforms-lite' ),
'path' => 'admin.php?page=wpforms-tools&view=action-scheduler&s=wpforms',
'wpforms-tools-logs' => [
'title' => esc_html__( 'Logs', 'wpforms-lite' ),
'path' => 'admin.php?page=wpforms-tools&view=logs',
'wpforms-tools-wpcode' => [
'title' => esc_html__( 'Code Snippets', 'wpforms-lite' ),
'path' => 'admin.php?page=wpforms-tools&view=wpcode',
foreach ( $items as $item_id => $args ) {
'parent' => 'wpforms-tools',
'id' => sanitize_key( $item_id ),
'title' => esc_html( $args['title'] ),
'href' => admin_url( $args['path'] ),
* Fires after the Tools submenu item is registered.
* @param WP_Admin_Bar $wp_admin_bar WordPress Admin Bar object.
do_action( "wpforms_admin_bar_menu_register_tools_submenu_{$item_id}_after", $wp_admin_bar );
$this->register_action_scheduler_submenu( $wp_admin_bar );
* Register Action Scheduler submenu.
* @param WP_Admin_Bar $wp_admin_bar WordPress Admin Bar object.
private function register_action_scheduler_submenu( WP_Admin_Bar $wp_admin_bar ) {
* Filters the Action Scheduler submenu items.
* @param array $items Array of submenu items.
* @param WP_Admin_Bar $wp_admin_bar WordPress Admin Bar object.
'wpforms_admin_bar_menu_register_action_scheduler_submenu',
'wpforms-tools-action-scheduler-all' => [
'title' => esc_html__( 'View All', 'wpforms-lite' ),
'path' => 'admin.php?page=wpforms-tools&view=action-scheduler&s=wpforms&orderby=hook&order=desc',
'wpforms-tools-action-scheduler-complete' => [
'title' => esc_html__( 'Completed Actions', 'wpforms-lite' ),
'path' => 'admin.php?page=wpforms-tools&view=action-scheduler&s=wpforms&status=complete&orderby=hook&order=desc',
'wpforms-tools-action-scheduler-failed' => [
'title' => esc_html__( 'Failed Actions', 'wpforms-lite' ),
'path' => 'admin.php?page=wpforms-tools&view=action-scheduler&s=wpforms&status=failed&orderby=hook&order=desc',
'wpforms-tools-action-scheduler-pending' => [
'title' => esc_html__( 'Pending Actions', 'wpforms-lite' ),
'path' => 'admin.php?page=wpforms-tools&view=action-scheduler&s=wpforms&status=pending&orderby=hook&order=desc',
'wpforms-tools-action-scheduler-past-due' => [
'title' => esc_html__( 'Past Due Actions', 'wpforms-lite' ),
'path' => 'admin.php?page=wpforms-tools&view=action-scheduler&s=wpforms&status=past-due&orderby=hook&order=desc',
foreach ( $items as $item_id => $args ) {
'parent' => 'wpforms-tools-action-scheduler',
'id' => sanitize_key( $item_id ),
'title' => esc_html( $args['title'] ),
'href' => admin_url( $args['path'] ),
* Fires after the Action Scheduler submenu item is registered.
* @param WP_Admin_Bar $wp_admin_bar WordPress Admin Bar object.
do_action( "wpforms_admin_bar_menu_register_action_scheduler_submenu_{$item_id}_after", $wp_admin_bar );
* Render primary top-level admin bar menu item.
* @param WP_Admin_Bar $wp_admin_bar WordPress Admin Bar object.
public function main_menu( WP_Admin_Bar $wp_admin_bar ) {
$notifications = $this->has_notifications();
$count = $notifications < 10 ? $notifications : '!';
$indicator = ' <div class="wp-core-ui wp-ui-notification wpforms-menu-notification-counter">' . $count . '</div>';
'title' => 'WPForms' . $indicator,
'href' => admin_url( 'admin.php?page=wpforms-overview' ),
* Render Notifications admin bar menu item.
* @param WP_Admin_Bar $wp_admin_bar WordPress Admin Bar object.
public function notification_menu( WP_Admin_Bar $wp_admin_bar ) {
if ( ! $this->has_notifications() ) {
'parent' => 'wpforms-menu',
'id' => 'wpforms-notifications',
'title' => esc_html__( 'Notifications', 'wpforms-lite' ) . ' <div class="wp-core-ui wp-ui-notification wpforms-menu-notification-indicator"></div>',
'href' => admin_url( 'admin.php?page=wpforms-overview' ),
* Render All Forms admin bar menu item.
* @param WP_Admin_Bar $wp_admin_bar WordPress Admin Bar object.
public function all_forms_menu( WP_Admin_Bar $wp_admin_bar ) {
'parent' => 'wpforms-menu',
'title' => esc_html__( 'All Forms', 'wpforms-lite' ),
'href' => admin_url( 'admin.php?page=wpforms-overview' ),
* Render All Payments admin bar menu item.
* @param WP_Admin_Bar $wp_admin_bar WordPress Admin Bar object.
public function all_payments_menu( WP_Admin_Bar $wp_admin_bar ) {
'parent' => 'wpforms-menu',
'id' => 'wpforms-payments',
'title' => esc_html__( 'Payments', 'wpforms-lite' ),
'page' => 'wpforms-payments',