init_hooks(); } /** * Hook into actions and filters. */ public function init_hooks(): void { if ( wpex_is_request( 'admin' ) ) { add_action( 'admin_menu', [ $this, 'add_admin_submenu_page' ], 20 ); add_action( 'admin_init', [ $this, 'register_page_options' ] ); } if ( totaltheme_call_static( 'Footer\Core', 'is_custom' ) ) { if ( ! get_theme_mod( 'footer_builder_footer_widgets', false ) ) { add_filter( 'wpex_register_footer_sidebars', '__return_false' ); } if ( wpex_is_request( 'frontend' ) ) { add_action( 'wp', [ $this, 'alter_footer' ] ); add_filter( 'wpex_head_css', [ $this, 'filter_wpex_head_css' ], 99 ); } } } /** * Add sub menu page. */ public function add_admin_submenu_page(): void { $hook_suffix = add_submenu_page( WPEX_THEME_PANEL_SLUG, esc_html__( 'Footer Builder', 'total' ), esc_html__( 'Footer Builder', 'total' ), 'edit_theme_options', WPEX_THEME_PANEL_SLUG . '-footer-builder', [ $this, 'render_admin_page' ] ); add_action( "load-{$hook_suffix}", [ $this, 'admin_help_tab' ] ); } /** * Add admin help tab. */ public function admin_help_tab(): void { $screen = get_current_screen(); if ( ! $screen ) { return; } $screen->add_help_tab( [ 'id' => 'totaltheme_footer_builder', 'title' => esc_html__( 'Overview', 'total' ), 'content' => '

' . esc_html__( 'By default the footer consists of a simple widgetized area which you can control via the WordPress Customizer. For more complex layouts you can use the option below to select a template and create your own custom footer layout from scratch.', 'total' ) . '

' ] ); } /** * Function that will register admin page options. */ public function register_page_options(): void { register_setting( 'wpex_footer_builder', 'footer_builder', array( 'sanitize_callback' => array( $this, 'save_options' ), 'default' => null ) ); add_settings_section( 'wpex_footer_builder_main', false, array( $this, 'section_main_callback' ), 'wpex-footer-builder-admin' ); add_settings_field( 'footer_builder_page_id', esc_html__( 'Footer Template', 'total' ), array( $this, 'content_id_field_callback' ), 'wpex-footer-builder-admin', 'wpex_footer_builder_main', array( 'label_for' => 'wpex-footer-builder-select', ) ); add_settings_field( 'footer_builder_color_scheme', esc_html__( 'Color Scheme', 'total' ), array( $this, 'footer_builder_color_scheme_field_callback' ), 'wpex-footer-builder-admin', 'wpex_footer_builder_main', array( 'label_for' => 'wpex-footer-builder-color-scheme', ) ); add_settings_field( 'footer_builder_footer_bottom', esc_html__( 'Footer Bottom', 'total' ), array( $this, 'footer_builder_footer_bottom_field_callback' ), 'wpex-footer-builder-admin', 'wpex_footer_builder_main', array( 'label_for' => 'wpex-footer-builder-footer-bottom', ) ); add_settings_field( 'footer_builder_footer_widgets', esc_html__( 'Footer Widgets', 'total' ), array( $this, 'footer_widgets_field_callback' ), 'wpex-footer-builder-admin', 'wpex_footer_builder_main', array( 'label_for' => 'wpex-footer-builder-widgets', ) ); add_settings_field( 'fixed_footer', esc_html__( 'Fixed Footer', 'total' ), array( $this, 'fixed_footer_field_callback' ), 'wpex-footer-builder-admin', 'wpex_footer_builder_main', array( 'label_for' => 'wpex-footer-builder-fixed', ) ); add_settings_field( 'footer_reveal', esc_html__( 'Footer Reveal', 'total' ), array( $this, 'footer_reveal_field_callback' ), 'wpex-footer-builder-admin', 'wpex_footer_builder_main', array( 'label_for' => 'wpex-footer-builder-reveal', ) ); add_settings_field( 'bg', esc_html__( 'Background Color', 'total' ), array( $this, 'bg_field_callback' ), 'wpex-footer-builder-admin', 'wpex_footer_builder_main', array( 'label_for' => 'wpex-footer-builder-bg', ) ); add_settings_field( 'bg_img', esc_html__( 'Background Image', 'total' ), array( $this, 'bg_img_field_callback' ), 'wpex-footer-builder-admin', 'wpex_footer_builder_main', array( 'label_for' => 'wpex-footer-builder-bg-img', ) ); add_settings_field( 'bg_img_style', esc_html__( 'Background Image Style', 'total' ), array( $this, 'bg_img_style_field_callback' ), 'wpex-footer-builder-admin', 'wpex_footer_builder_main', array( 'label_for' => 'wpex-footer-builder-bg-style', ) ); } /** * Save options. */ public function save_options( $options ): void { if ( ! isset( $_POST['totaltheme-footer-builder-admin-nonce'] ) || ! wp_verify_nonce( \sanitize_text_field( wp_unslash( $_POST['totaltheme-footer-builder-admin-nonce'] ) ), 'totaltheme-footer-builder-admin' ) || ! current_user_can( 'edit_theme_options' ) ) { return; } // Update footer builder page ID if ( ! empty( $options['content_id'] ) ) { set_theme_mod( 'footer_builder_page_id', $options['content_id'] ); } else { remove_theme_mod( 'footer_builder_page_id' ); } // Color scheme. if ( ! empty( $options['color_scheme'] ) ) { set_theme_mod( 'footer_builder_color_scheme', $options['color_scheme'] ); } else { remove_theme_mod( 'footer_builder_color_scheme' ); } // Footer Bottom - Disabled by default if ( empty( $options['footer_builder_footer_bottom'] ) ) { remove_theme_mod( 'footer_builder_footer_bottom' ); } else { set_theme_mod( 'footer_builder_footer_bottom', 1 ); } // Footer Widgets - Disabled by default if ( empty( $options['footer_builder_footer_widgets'] ) ) { remove_theme_mod( 'footer_builder_footer_widgets' ); } else { set_theme_mod( 'footer_builder_footer_widgets', 1 ); } // Update fixed footer - Disabled by default if ( empty( $options['fixed_footer'] ) ) { remove_theme_mod( 'fixed_footer' ); } else { set_theme_mod( 'fixed_footer', 1 ); } // Update footer Reveal - Disabled by default if ( empty( $options['footer_reveal'] ) ) { remove_theme_mod( 'footer_reveal' ); } else { set_theme_mod( 'footer_reveal', true ); } // Update bg if ( empty( $options['bg'] ) ) { remove_theme_mod( 'footer_builder_bg' ); } else { set_theme_mod( 'footer_builder_bg', \sanitize_text_field( $options['bg'] ) ); } // Update bg img if ( empty( $options['bg_img'] ) ) { remove_theme_mod( 'footer_builder_bg_img' ); } else { set_theme_mod( 'footer_builder_bg_img', \sanitize_text_field( $options['bg_img'] ) ); } // Update bg img style if ( empty( $options['bg_img_style'] ) ) { remove_theme_mod( 'footer_builder_bg_img_style' ); } else { set_theme_mod( 'footer_builder_bg_img_style', \sanitize_text_field( $options['bg_img_style'] ) ); } } /** * Main Settings section callback. */ public function section_main_callback( $options ): void {} /** * Fields callback functions. */ // Footer Builder Page ID public function content_id_field_callback(): void { $selected_template = get_theme_mod( 'footer_builder_page_id' ); $template_exists = ( $selected_template && get_post_status( $selected_template ) ); totaltheme_call_non_static( 'Theme_Builder', 'template_select', [ 'id' => 'wpex-footer-builder-select', 'name' => 'footer_builder[content_id]', 'selected' => $selected_template, 'template_type' => 'footer', ] ); ?>

edit_links( $selected_template ); ?>
> > > > 'wpex-footer-builder-bg', 'value' => ( $value = get_theme_mod( 'footer_builder_bg' ) ) ? sanitize_text_field( $value ) : '', 'input_name' => 'footer_builder[bg]', 'dropdown_placement' => 'right', 'exclude' => 'term_color,custom_field', 'allow_gradient' => true, ] ); } /** * Background Image Setting. */ public function bg_img_field_callback(): void { $bg = get_theme_mod( 'footer_builder_bg_img' ); ?>
<?php esc_html_e( 'Preview Image', 'total' ); ?>

' . esc_html__( 'Please switch to the default site language or "all" languages.', 'your-text-domain' ) . '

'; return; } } // Deleted template notice if ( $template_id && ( false === get_post_status( $template_id ) || 'trash' === get_post_status( $template_id ) ) ) { echo '

' . esc_html__( 'It appears the page you had selected has been deleted, please re-save your settings to prevent issues.', 'total' ) . '

'; } ?>
insert_hook ) { return $this->insert_hook; } $hook = totaltheme_call_static( 'Footer\Core', 'has_classic_layout' ) ? 'wpex_hook_footer_before' : 'wpex_hook_footer_top'; $this->insert_hook = (string) apply_filters( 'wpex_footer_builder_insert_hook', $hook ); return $this->insert_hook; } /** * Returns the insert hook priority for the custom footer. */ private function get_insert_priority(): int { if ( null !== $this->insert_priority ) { return $this->insert_priority; } $this->insert_priority = (int) apply_filters( 'wpex_footer_builder_insert_priority', 40 ); return $this->insert_priority; } /** * Alter the footer. */ public function alter_footer(): void { add_action( $this->get_insert_hook(), [ $this, 'get_part' ], $this->get_insert_priority() ); } /** * Gets the footer builder template part if the footer is enabled. */ public function get_part(): void { if ( totaltheme_call_static( 'Footer\Core', 'is_enabled' ) ) { get_template_part( 'partials/footer/footer-builder' ); } } /** * Custom CSS for footer builder. */ public function filter_wpex_head_css( string $css ): string { $add_css = ''; // Custom background color $bg = get_theme_mod( 'footer_builder_bg' ); if ( $bg ) { if ( str_starts_with( $bg, 'type:linear-gradient' ) || str_starts_with( $bg, 'type:radial-gradient' ) ) { $bg_css = (string) totaltheme_call_static( 'Helpers\Gradient_Parser', 'render_css', $bg ); if ( $bg_css ) { $add_css .= "background-image:{$bg_css}!important;"; } } else { $bg_safe = wpex_parse_color( $bg ); if ( $bg_safe ) { $add_css .= "background-color:{$bg_safe};"; } } } // Custom background image $bg_img = get_theme_mod( 'footer_builder_bg_img' ); if ( $bg_img && $bg_img_safe = esc_url( wpex_get_image_url( $bg_img ) ) ) { $add_css .= "background-image:url({$bg_img_safe});"; } // Custom background image style // @todo update to use utility classes so that the fixed backgrounds don't get messed up on mobile? if ( $bg_img && $bg_img_style = get_theme_mod( 'footer_builder_bg_img_style' ) ) { $add_css .= wpex_sanitize_data( $bg_img_style, 'background_style_css' ); } if ( $add_css ) { $css .= "/*FOOTER BUILDER*/#footer-builder{{$add_css}}"; } return $css; } /** * Get edit links. */ public function edit_links( $template_id = '' ): void { if ( ! $template_id || ! current_user_can( 'edit_post', $template_id ) ) { return; } $edit_link = get_edit_post_link( $template_id ); if ( ! $edit_link ) { return; } $template_type = get_post_type( $template_id ); ?> " class="button" target="_blank" rel="noopener noreferrer"> " class="button" target="_blank" rel="noopener noreferrer">