* * @version 1.0.0 * @package HFG */ namespace HFG\Core\Builder; use HFG\Main; use Neve\Core\Migration_Flags; use Neve\Core\Theme_Info; use WP_Customize_Manager; /** * Class Footer * * @package HFG\Core\Builder */ class Footer extends Abstract_Builder { use Theme_Info; /** * Builder name. */ const BUILDER_NAME = 'footer'; /** * Footer constructor. * * @since 1.0.0 * @access public */ public function init() { $this->set_property( 'title', __( 'Footer', 'neve' ) ); $this->set_property( 'columns_layout', true ); $this->set_property( 'description', apply_filters( 'hfg_footer_panel_description', sprintf( /* translators: %s link to documentation */ esc_html__( 'Design your %1$s by dragging, dropping and resizing all the elements in real-time. %2$s.', 'neve' ), /* translators: %s builder type */ $this->get_property( 'title' ), /* translators: %s link text */ sprintf( '
%s', esc_html__( '(opens in a new tab)', 'neve' ), esc_html__( 'Read full documentation', 'neve' ) ) ) ) ); $user_after_v41 = Migration_Flags::is_new_user_after_v41(); $upgrade_url_copyright = tsdk_translate_link( tsdk_utmify( 'https://themeisle.com/themes/neve/upgrade/', $user_after_v41 ? 'copyright_dynamiclinks' : 'copyright' ), 'query' ); $copyright_quicklink_config = [ 'label' => esc_html__( 'Change Copyright', 'neve' ), 'icon' => 'dashicons-nametag', ]; if ( ! $user_after_v41 ) { $copyright_quicklink_config['url'] = $this->has_valid_addons() ? null : $upgrade_url_copyright; $copyright_quicklink_config['badge'] = esc_html__( 'PRO', 'neve' ); } if ( ! $this->has_valid_addons() ) { $copyright_quicklink_config['upsellDescription'] = sprintf( $user_after_v41 /* translators: %1$s: opening anchor tag, %2$s: closing anchor tag */ ? __( 'Personalize your site\'s footer text! Many users choose to keep our small "Powered by Neve" credit — thank you! %1$sUpgrade to Pro%2$s for dynamic tags, HTML formatting, and advanced styling controls.', 'neve' ) /* translators: %1$s: opening anchor tag, %2$s: closing anchor tag */ : __( 'The Neve theme free version doesn\'t support copyright edits. Pro unlocks this and more—%1$sexplore%2$s it when you\'re ready!', 'neve' ), '', '' ); } $this->set_property( 'instructions_array', array( 'description' => sprintf( /* translators: 1: builder, 2: builder symbol */ esc_attr__( 'Welcome to the %1$s builder! Click the %2$s button to add a new component or follow the Quick Links.', 'neve' ), $this->get_property( 'title' ), '+' ), 'quickLinks' => array( 'footer_copyright_content' => $copyright_quicklink_config, 'hfg_footer_layout_bottom_background' => array( 'label' => esc_html__( 'Change Footer Color', 'neve' ), 'icon' => 'dashicons-admin-appearance', ), ), ) ); $this->devices = [ 'desktop' => __( 'Desktop', 'neve' ), 'mobile' => __( 'Mobile', 'neve' ), ]; /** * Fix legacy search widget display in footer * Only applies for versions < 5.8 */ add_filter( 'dynamic_sidebar_params', function ( $params ) { $processed_params = []; $has_legacy_search_style = apply_filters( 'neve_has_legacy_search_style_filter', false ); foreach ( $params as $param ) { if ( isset( $param['before_widget'] ) && strpos( $param['before_widget'], 'widget_search' ) !== false && $has_legacy_search_style === false ) { $param['before_widget'] = '' . $param['before_widget']; add_filter( 'neve_has_legacy_search_style_filter', '__return_true' ); } array_push( $processed_params, $param ); } return $processed_params; } ); /** * Add mobile footer layout if not present using the same layout from desktop if mobile is empty. * This will apply from Neve 3.5.8 and offer backward compatibility for users that have not set a mobile footer layout. * * @since 3.5.8 */ add_filter( 'theme_mod_hfg_footer_layout_v2', function ( $value ) { if ( is_string( $value ) ) { $maybe_parse_json = json_decode( $value, true ); if ( ! empty( $maybe_parse_json['mobile'] ) ) { return $value; } $maybe_parse_json['mobile'] = $maybe_parse_json['desktop']; return wp_json_encode( $maybe_parse_json ); } return $value; } ); add_action( 'neve_after_slot_component', [ $this, 'add_footer_component' ], 10, 3 ); } /** * Called to register component controls. * * @param WP_Customize_Manager $wp_customize The Customize Manager. * * @return WP_Customize_Manager * @since 4.0.1 * @access public */ public function customize_register( WP_Customize_Manager $wp_customize ) { if ( $this->has_valid_addons() || ! Migration_Flags::is_new_user_after_v41() ) { return parent::customize_register( $wp_customize ); } $wp_customize->add_section( 'neve_footer_copyright_section', [ 'title' => __( 'Change Copyright', 'neve' ), 'priority' => 200, 'panel' => 'hfg_footer', ] ); $wp_customize->add_setting( 'footer_copyright_content', [ 'default' => $this->get_copyright_default(), 'sanitize_callback' => 'wp_kses_post', ] ); $wp_customize->add_control( 'footer_copyright_content', [ 'label' => __( 'Text', 'neve' ), 'section' => 'neve_footer_copyright_section', 'type' => 'textarea', 'setting' => 'footer_copyright_content', ] ); return parent::customize_register( $wp_customize ); } /** * Add footer component. * * @param string $builder Builder slug. * @param string $row Row slug. * @param string $slot Slot name. * * @return void */ public function add_footer_component( $builder, $row, $slot ) { if ( $this->has_valid_addons() ) { return; } if ( $builder !== self::BUILDER_NAME ) { return; } if ( $row !== 'bottom' ) { return; } if ( $slot !== 'left' ) { return; } $value = get_theme_mod( 'footer_copyright_content', $this->get_copyright_default() ); $output = '

'; $output .= wp_kses_post( $value ); $output .= '

'; echo wp_kses_post( $output ); } /** * Method called via hook. * * @since 1.0.0 * @access public */ public function load_template() { Main::get_instance()->load( 'footer-wrapper' ); } /** * Render builder row. * * @param string $device_id The device id. * @param string $row_id The row id. * @param array $row_details Row data. */ public function render_row( $device_id, $row_id, $row_details ) { Main::get_instance()->load( 'footer-row-wrapper' ); } /** * Get builder id. * * @return string Builder id. */ public function get_id() { return self::BUILDER_NAME; } /** * Overrides parent method to limit rows. * * @return array * @since 1.0.0 * @access protected */ protected function get_rows() { if ( neve_is_new_builder() ) { return [ 'top' => array( 'title' => __( 'Footer Top', 'neve' ), 'description' => $this->get_property( 'description' ), ), 'main' => array( 'title' => __( 'Footer Main', 'neve' ), 'description' => $this->get_property( 'description' ), ), 'bottom' => array( 'title' => __( 'Footer Bottom', 'neve' ), 'description' => $this->get_property( 'description' ), ), ]; } return [ 'top' => array( 'title' => __( 'Footer Top', 'neve' ), 'description' => $this->get_property( 'description' ), ), 'bottom' => array( 'title' => __( 'Footer Bottom', 'neve' ), 'description' => $this->get_property( 'description' ), ), ]; } /** * Get upsell components. * * @return array */ protected function get_upsell_components() { if ( $this->has_valid_addons() ) { return []; } return [ [ 'icon' => 'email', 'name' => __( 'Contact', 'neve' ), ], [ 'icon' => 'images-alt', 'name' => __( 'Payment icons', 'neve' ), ], [ 'icon' => 'nametag', 'name' => __( 'Copyright', 'neve' ), ], [ 'icon' => 'embed-generic', 'name' => __( 'Custom Layouts', 'neve' ), ], [ 'icon' => 'welcome-widgets-menus', 'name' => __( 'Widget Area', 'neve' ), ], [ 'icon' => 'share', 'name' => __( 'Social Icons', 'neve' ), ], ]; } /** * Get the default copyright text. * * @return string */ private function get_copyright_default() { return sprintf( /* translators: %1$s is Theme Name ( Neve ), %2$s is WordPress */ __( '%1$s | Powered by %2$s', 'neve' ), '

Neve', 'WordPress

' ); } }