'chevron', 'icon_size' => 40, 'icon_color' => '#ffffff', 'label_text' => '', 'bottom_offset' => '5', 'anchor_target' => '#start', 'trigger_class' => 'has-scroll-down', 'auto_target' => 1, 'animate' => 1, ); public function slug(): string { return 'scroll_down'; } public function label(): string { return __( 'Scroll Down', 'bw-dev' ); } public function group(): string { return 'frontend'; } public function default_settings(): array { return self::DEFAULTS; } /** * Available indicator icons. Each value is a stroke-based SVG with no * width/height/color — those are injected by icon_svg(). */ private static function icons(): array { return array( 'chevron' => array( 'label' => __( 'Chevron', 'bw-dev' ), 'svg' => '', ), 'chevron-double' => array( 'label' => __( 'Double Chevron', 'bw-dev' ), 'svg' => '', ), 'arrow' => array( 'label' => __( 'Arrow', 'bw-dev' ), 'svg' => '', ), 'arrow-circle' => array( 'label' => __( 'Circle Arrow', 'bw-dev' ), 'svg' => '', ), 'mouse' => array( 'label' => __( 'Mouse', 'bw-dev' ), 'svg' => '', ), 'angle' => array( 'label' => __( 'Angle', 'bw-dev' ), 'svg' => '', ), ); } public function sanitize( array $data ): array { $icons = self::icons(); $icon_type = isset( $data['icon_type'] ) ? sanitize_text_field( wp_unslash( (string) $data['icon_type'] ) ) : self::DEFAULTS['icon_type']; $icon_type = isset( $icons[ $icon_type ] ) ? $icon_type : self::DEFAULTS['icon_type']; $icon_size = isset( $data['icon_size'] ) ? max( 20, min( 100, absint( $data['icon_size'] ) ) ) : self::DEFAULTS['icon_size']; $icon_color = isset( $data['icon_color'] ) ? sanitize_hex_color( wp_unslash( (string) $data['icon_color'] ) ) : ''; $icon_color = $icon_color ? $icon_color : self::DEFAULTS['icon_color']; $label_text = isset( $data['label_text'] ) ? sanitize_text_field( wp_unslash( (string) $data['label_text'] ) ) : ''; $bottom_offset = isset( $data['bottom_offset'] ) ? sanitize_text_field( wp_unslash( (string) $data['bottom_offset'] ) ) : self::DEFAULTS['bottom_offset']; $bottom_offset = preg_match( '/^[0-9]+(px|%)?$/', $bottom_offset ) ? $bottom_offset : self::DEFAULTS['bottom_offset']; $anchor = isset( $data['anchor_target'] ) ? sanitize_text_field( wp_unslash( (string) $data['anchor_target'] ) ) : self::DEFAULTS['anchor_target']; if ( '' !== $anchor && 0 !== strpos( $anchor, '#' ) ) { $anchor = '#' . $anchor; } $anchor = '' !== $anchor ? $anchor : self::DEFAULTS['anchor_target']; $trigger_class = isset( $data['trigger_class'] ) ? sanitize_html_class( wp_unslash( (string) $data['trigger_class'] ) ) : ''; $trigger_class = $trigger_class ? $trigger_class : self::DEFAULTS['trigger_class']; return array( 'icon_type' => $icon_type, 'icon_size' => $icon_size, 'icon_color' => $icon_color, 'label_text' => $label_text, 'bottom_offset' => $bottom_offset, 'anchor_target' => $anchor, 'trigger_class' => $trigger_class, 'auto_target' => ! empty( $data['auto_target'] ) ? 1 : 0, 'animate' => ! empty( $data['animate'] ) ? 1 : 0, ); } private function settings(): array { $saved = bw_dev()->settings()->get( $this->slug(), null, array() ); return wp_parse_args( is_array( $saved ) ? $saved : array(), self::DEFAULTS ); } private function get( string $key ) { $s = $this->settings(); return $s[ $key ] ?? ( self::DEFAULTS[ $key ] ?? null ); } /** * Build an icon SVG with width/height/color injected. The icon key is * validated against the known set; $color is escaped for the style attr, * $size is cast to int. */ private function icon_svg( string $icon_type, int $size = 40, string $color = '#ffffff' ): string { $icons = self::icons(); $icon = $icons[ $icon_type ] ?? $icons['chevron']; return str_replace( 'slug() !== $tab ) { return; } wp_enqueue_style( 'wp-color-picker' ); wp_enqueue_script( 'wp-color-picker' ); } public function output_css(): void { $trigger = sanitize_html_class( (string) $this->get( 'trigger_class' ) ); $bottom = $this->parse_offset( (string) $this->get( 'bottom_offset' ) ); ?> get( 'icon_color' ); $color = $color ? $color : '#ffffff'; $size = (int) $this->get( 'icon_size' ); wp_localize_script( 'bw-dev-scroll-down', 'bwDevScrollDownConfig', array( 'anchorTarget' => (string) $this->get( 'anchor_target' ), 'labelText' => (string) $this->get( 'label_text' ), 'iconSvg' => $this->icon_svg( (string) $this->get( 'icon_type' ), $size, $color ), 'iconColor' => $color, 'triggerClass' => sanitize_html_class( (string) $this->get( 'trigger_class' ) ), 'autoTarget' => (bool) $this->get( 'auto_target' ), 'animateClass' => $this->get( 'animate' ) ? ' bw-dev-scroll-down--animated' : '', ) ); } /** * Shortcode: [bw_dev_scroll_down anchor="" label="" icon="" size="" color=""] */ public function shortcode_output( $atts = array() ): string { $atts = shortcode_atts( array( 'anchor' => (string) $this->get( 'anchor_target' ), 'label' => (string) $this->get( 'label_text' ), 'icon' => (string) $this->get( 'icon_type' ), 'size' => (int) $this->get( 'icon_size' ), 'color' => (string) $this->get( 'icon_color' ), ), $atts, 'bw_dev_scroll_down' ); $anchor = esc_attr( (string) $atts['anchor'] ); $label = esc_html( (string) $atts['label'] ); $size = absint( $atts['size'] ); $color = esc_attr( (string) $atts['color'] ); $color = $color ? $color : '#ffffff'; $animate_class = $this->get( 'animate' ) ? ' bw-dev-scroll-down--animated' : ''; $label_html = '' !== $label ? '' . $label . '' : ''; $icon_svg = $this->icon_svg( isset( self::icons()[ $atts['icon'] ] ) ? (string) $atts['icon'] : 'chevron', $size, $color ); $out = '
'; $out .= $label_html; $out .= ''; $out .= '' . $icon_svg . ''; $out .= ''; $out .= '
'; return $out; } public function render_tab(): void { $settings = $this->settings(); $icons = self::icons(); $pfx = BW_Dev_Settings::OPTION . '[' . $this->slug() . ']'; ?>

$icon ) : $is_sel = ( $settings['icon_type'] === $key ); ?>

shortcode_output(); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- escaped at source. ?>

[bw_dev_scroll_down]

' . esc_html( (string) $settings['trigger_class'] ) . '' ); ?>