list_options(); $this->box_setting_style(); $this->title_settings(); $this->list_settings(); } public function list_options() { $this->start_controls_section( 'section_options', [ 'label' => __( 'Controls', 'betterdocs' ) ] ); $this->add_control( 'toc_title', [ 'label' => __( 'TOC Title', 'betterdocs' ), 'type' => Controls_Manager::TEXT, 'default' => esc_html__( 'Table of contents', 'betterdocs' ) ] ); $this->add_control( 'htags', [ 'label' => __( 'Supported Heading Tags', 'betterdocs' ), 'type' => Controls_Manager::SELECT2, 'multiple' => true, 'options' => [ '1' => __( 'H1', 'betterdocs' ), '2' => __( 'H2', 'betterdocs' ), '3' => __( 'H3', 'betterdocs' ), '4' => __( 'H4', 'betterdocs' ), '5' => __( 'H5', 'betterdocs' ), '6' => __( 'H6', 'betterdocs' ) ], 'default' => [ '1', '2', '3', '4', '5', '6' ] ] ); $this->add_responsive_control( 'list_hierarchy', [ 'label' => __( 'List Hierarchy', 'betterdocs' ), 'type' => Controls_Manager::SWITCHER, 'label_on' => __( 'Show', 'betterdocs' ), 'label_off' => __( 'Hide', 'betterdocs' ), 'return_value' => '1', 'default' => '1' ] ); $this->add_responsive_control( 'list_number', [ 'label' => __( 'List Number', 'betterdocs' ), 'type' => Controls_Manager::SWITCHER, 'label_on' => __( 'Show', 'betterdocs' ), 'label_off' => __( 'Hide', 'betterdocs' ), 'return_value' => '1', 'default' => '1' ] ); $this->add_responsive_control( 'collapsible_toc_mobile', [ 'label' => __( 'Collapsible on small devices', 'betterdocs' ), 'type' => Controls_Manager::SWITCHER, 'label_on' => __( 'Show', 'betterdocs' ), 'label_off' => __( 'Hide', 'betterdocs' ), 'return_value' => '1', 'default' => '' ] ); $this->end_controls_section(); } public function box_setting_style() { /** * ---------------------------------------------------------- * Section: Box Styles * ---------------------------------------------------------- */ $this->start_controls_section( 'section_card_settings', [ 'label' => __( 'Box', 'betterdocs' ), 'tab' => Controls_Manager::TAB_STYLE ] ); $this->add_responsive_control( 'column_width', // Legacy control id but new control [ 'label' => __( 'Box Width (%)', 'betterdocs' ), 'type' => Controls_Manager::NUMBER, 'min' => 0, 'max' => 100, 'step' => 5, 'default' => 100, 'selectors' => [ '{{WRAPPER}} .betterdocs-toc' => 'width: {{VALUE}}%;' ] ] ); $this->add_responsive_control( 'column_background', [ 'label' => esc_html__( 'Background Color', 'betterdocs' ), 'type' => Controls_Manager::COLOR, 'selectors' => [ '{{WRAPPER}} .betterdocs-toc' => 'background-color: {{VALUE}};' ] ] ); $this->add_responsive_control( 'column_space', // Legacy control id but new control [ 'label' => __( 'Box Spacing', 'betterdocs' ), 'type' => Controls_Manager::DIMENSIONS, 'size_units' => [ 'px', '%', 'em' ], 'selectors' => [ '{{WRAPPER}} .betterdocs-toc' => 'margin: {{TOP}}{{UNIT}} {{RIGHT}}{{UNIT}} {{BOTTOM}}{{UNIT}} {{LEFT}}{{UNIT}};' ] ] ); $this->add_responsive_control( 'column_padding', [ 'label' => __( 'Box Padding', 'betterdocs' ), 'type' => Controls_Manager::DIMENSIONS, 'size_units' => [ 'px', 'em', '%' ], 'selectors' => [ '{{WRAPPER}} .betterdocs-toc' => 'padding: {{TOP}}{{UNIT}} {{RIGHT}}{{UNIT}} {{BOTTOM}}{{UNIT}} {{LEFT}}{{UNIT}};' ] ] ); $this->add_responsive_control( 'column_border_radius', [ 'label' => esc_html__( 'Box Border Radius', 'betterdocs' ), 'type' => Controls_Manager::DIMENSIONS, 'size_units' => [ 'px', 'em', '%' ], 'selectors' => [ '{{WRAPPER}} .betterdocs-toc' => 'border-radius: {{TOP}}{{UNIT}} {{RIGHT}}{{UNIT}} {{BOTTOM}}{{UNIT}} {{LEFT}}{{UNIT}};' ] ] ); $this->add_responsive_control( 'align', [ 'label' => __( 'Alignment', 'betterdocs' ), 'type' => Controls_Manager::CHOOSE, 'options' => [ 'left' => [ 'title' => __( 'Left', 'betterdocs' ), 'icon' => 'eicon-text-align-left' ], 'center' => [ 'title' => __( 'Center', 'betterdocs' ), 'icon' => 'eicon-text-align-center' ], 'right' => [ 'title' => __( 'Right', 'betterdocs' ), 'icon' => 'eicon-text-align-right' ], 'justify' => [ 'title' => __( 'Justified', 'betterdocs' ), 'icon' => 'eicon-text-align-justify' ] ], 'default' => '', 'selectors' => [ '{{WRAPPER}}' => 'text-align: {{VALUE}};' ] ] ); $this->end_controls_section(); # end of 'Card Settings' } public function title_settings() { $this->start_controls_section( 'section_title', [ 'label' => __( 'Title', 'betterdocs' ), 'tab' => Controls_Manager::TAB_STYLE ] ); $this->add_control( 'title_color', [ 'label' => __( 'Text Color', 'betterdocs' ), 'type' => Controls_Manager::COLOR, 'selectors' => [ '{{WRAPPER}} .betterdocs-toc .toc-title' => 'color: {{VALUE}};' ] ] ); $this->add_group_control( Group_Control_Typography::get_type(), [ 'name' => 'typography', 'selector' => '{{WRAPPER}} .betterdocs-toc .toc-title' ] ); $this->add_group_control( Group_Control_Text_Shadow::get_type(), [ 'name' => 'text_shadow', 'selector' => '{{WRAPPER}} .betterdocs-toc .toc-title' ] ); $this->add_control( 'blend_mode', [ 'label' => __( 'Blend Mode', 'betterdocs' ), 'type' => Controls_Manager::SELECT, 'options' => [ '' => __( 'Normal', 'betterdocs' ), 'multiply' => 'Multiply', 'screen' => 'Screen', 'overlay' => 'Overlay', 'darken' => 'Darken', 'lighten' => 'Lighten', 'color-dodge' => 'Color Dodge', 'saturation' => 'Saturation', 'color' => 'Color', 'difference' => 'Difference', 'exclusion' => 'Exclusion', 'hue' => 'Hue', 'luminosity' => 'Luminosity' ], 'selectors' => [ '{{WRAPPER}} .betterdocs-toc .toc-title' => 'mix-blend-mode: {{VALUE}}' ], 'separator' => 'none' ] ); $this->add_responsive_control( 'title_padding', [ 'label' => esc_html__( 'Title Padding', 'betterdocs' ), 'type' => Controls_Manager::DIMENSIONS, 'size_units' => [ 'px', 'em', '%' ], 'selectors' => [ '{{WRAPPER}} .betterdocs-toc .toc-title' => 'padding: {{TOP}}{{UNIT}} {{RIGHT}}{{UNIT}} {{BOTTOM}}{{UNIT}} {{LEFT}}{{UNIT}};' ] ] ); $this->add_responsive_control( 'title_margin', [ 'label' => esc_html__( 'Title Margin', 'betterdocs' ), 'type' => Controls_Manager::DIMENSIONS, 'size_units' => [ 'px', 'em', '%' ], 'selectors' => [ '{{WRAPPER}} .betterdocs-toc .toc-title' => 'margin: {{TOP}}{{UNIT}} {{RIGHT}}{{UNIT}} {{BOTTOM}}{{UNIT}} {{LEFT}}{{UNIT}};' ] ] ); $this->end_controls_section(); $this->update_control( 'title', [ 'dynamic' => [ 'default' => ElementorProPlugin::elementor()->dynamic_tags->tag_data_to_tag_text( null, 'betterdocs-title-tag' ) ] ], [ 'recursive' => true ] ); } public function list_settings() { /** * ---------------------------------------------------------- * Section: List Settinggs * ---------------------------------------------------------- */ $this->start_controls_section( 'section_article_settings', [ 'label' => __( 'Toc List', 'betterdocs' ), 'tab' => Controls_Manager::TAB_STYLE ] ); $this->add_group_control( Group_Control_Typography::get_type(), [ 'name' => 'list_item_typography', 'selector' => '{{WRAPPER}} .betterdocs-toc ul li a' ] ); $this->add_control( 'list_word_wrap', [ 'label' => __( 'Word Wrap', 'betterdocs' ), 'type' => Controls_Manager::SELECT2, 'multiple' => false, 'options' => [ 'normal' => 'normal', 'break-word' => 'break-word', 'initial' => 'initial', 'inherit' => 'inherit' ], 'default' => 'normal', 'selectors' => [ '{{WRAPPER}} .betterdocs-toc ul li a' => 'word-wrap: {{VALUE}};' ] ] ); $this->add_responsive_control( 'list_border_left_full', [ 'label' => __( 'Left Border Line', 'betterdocs' ), 'type' => Controls_Manager::SLIDER, 'size_units' => [ 'px', '%' ], 'range' => [ 'px' => [ 'min' => 0, 'max' => 1000, 'step' => 1 ], '%' => [ 'min' => 0, 'max' => 100 ] ], 'default' => [ 'unit' => 'px', 'size' => 0 ], 'selectors' => [ '{{WRAPPER}} .betterdocs-toc ul.betterdocs-hierarchial-toc' => 'border-left: {{SIZE}}{{UNIT}} solid #D2D2D2; position:relative;' ] ] ); $this->add_responsive_control( 'list_border_left_full_space', [ 'label' => esc_html__( 'Left Border Line Space', 'betterdocs' ), 'type' => Controls_Manager::DIMENSIONS, 'size_units' => [ 'px', 'em', '%' ], 'default' => [ 'top' => '0', 'right' => '0', 'bottom' => '0', 'left' => '0', 'isLinked' => false ], 'selectors' => [ '{{WRAPPER}} .betterdocs-toc > .toc-list' => 'padding: {{TOP}}{{UNIT}} {{RIGHT}}{{UNIT}} {{BOTTOM}}{{UNIT}} {{LEFT}}{{UNIT}};' ] ] ); $this->add_responsive_control( 'list_border_left_positioning', [ 'label' => esc_html__( 'Left Border Line Positioning', 'betterdocs' ), 'type' => Controls_Manager::DIMENSIONS, 'size_units' => [ 'px', 'em', '%' ], 'default' => [ 'top' => '0', 'right' => '0', 'bottom' => '0', 'left' => '0', 'isLinked' => false ], 'selectors' => [ '{{WRAPPER}} .betterdocs-toc ul.betterdocs-hierarchial-toc' => 'margin: {{TOP}}{{UNIT}} {{RIGHT}}{{UNIT}} {{BOTTOM}}{{UNIT}} {{LEFT}}{{UNIT}};' ] ] ); $this->add_control( 'list_border_left_full_color', [ 'label' => __( 'Left Border Line Color', 'betterdocs' ), 'type' => Controls_Manager::COLOR, 'selectors' => [ '{{WRAPPER}} .betterdocs-toc ul.betterdocs-hierarchial-toc' => 'border-color: {{VALUE}};' ] ] ); $this->add_responsive_control( 'list_border_left', [ 'label' => __( 'Active List Left Border Width', 'betterdocs' ), 'type' => Controls_Manager::SLIDER, 'size_units' => [ 'px', '%' ], 'range' => [ 'px' => [ 'min' => 0, 'max' => 1000, 'step' => 1 ], '%' => [ 'min' => 0, 'max' => 100 ] ], 'default' => [ 'unit' => 'px', 'size' => 2 ], 'selectors' => [ '{{WRAPPER}} .betterdocs-toc ul.betterdocs-hierarchial-toc a.active:after' => 'width: {{SIZE}}{{UNIT}}; content:""; position: absolute; height: 1.6em; left: -1px ' ] ] ); $this->add_control( 'list_border_left_color', [ 'label' => __( 'Active Color Left Border', 'betterdocs' ), 'type' => Controls_Manager::COLOR, 'selectors' => [ '{{WRAPPER}} .betterdocs-toc > .toc-list a.active:after' => 'background-color: {{VALUE}};' ] ] ); // $this->add_responsive_control( // 'active_border_left_position', // [ // 'label' => esc_html__( 'Active Left Border Position', 'betterdocs' ), // 'type' => Controls_Manager::DIMENSIONS, // 'size_units' => ['px', 'em', '%'], // 'selectors' => [ // '{{WRAPPER}} .betterdocs-toc > .toc-list a.active:after' => 'left:{{LEFT}}{{UNIT}};', // '{{WRAPPER}} .betterdocs-toc > .toc-list a.active:after' => 'right:{{RIGHT}}{{UNIT}};', // '{{WRAPPER}} .betterdocs-toc > .toc-list a.active:after' => 'bottom:{{BOTTOM}}{{UNIT}};', // '{{WRAPPER}} .betterdocs-toc > .toc-list a.active:after' => 'top:{{TOP}}{{UNIT}};' // ] // ] // ); $this->add_responsive_control( 'active_border_left_position', [ 'label' => __( 'Active List Left Border Position Left', 'betterdocs' ), 'type' => Controls_Manager::SLIDER, 'size_units' => [ 'px', '%' ], 'range' => [ 'px' => [ 'min' => -1000, 'max' => 1000, 'step' => 1 ], '%' => [ 'min' => 0, 'max' => 100 ] ], 'default' => [ 'unit' => 'px', 'size' => 2 ], 'selectors' => [ '{{WRAPPER}} .betterdocs-toc > .toc-list a.active:after' => 'left:{{SIZE}}{{UNIT}}!important;', ] ] ); $this->add_responsive_control( 'active_border_right_position', [ 'label' => __( 'Active List Left Border Position Right', 'betterdocs' ), 'type' => Controls_Manager::SLIDER, 'size_units' => [ 'px', '%' ], 'range' => [ 'px' => [ 'min' => -1000, 'max' => 1000, 'step' => 1 ], '%' => [ 'min' => 0, 'max' => 100 ] ], 'default' => [ 'unit' => 'px', 'size' => 2 ], 'selectors' => [ '{{WRAPPER}} .betterdocs-toc > .toc-list a.active:after' => 'right:{{SIZE}}{{UNIT}}!important;', ] ] ); $this->add_responsive_control( 'active_border_bottom_position', [ 'label' => __( 'Active List Left Border Position Bottom', 'betterdocs' ), 'type' => Controls_Manager::SLIDER, 'size_units' => [ 'px', '%' ], 'range' => [ 'px' => [ 'min' => -1000, 'max' => 1000, 'step' => 1 ], '%' => [ 'min' => 0, 'max' => 100 ] ], 'default' => [ 'unit' => 'px', 'size' => 2 ], 'selectors' => [ '{{WRAPPER}} .betterdocs-toc > .toc-list a.active:after' => 'bottom:{{SIZE}}{{UNIT}}!important;', ] ] ); $this->add_responsive_control( 'active_border_top_position', [ 'label' => __( 'Active List Left Border Position Top', 'betterdocs' ), 'type' => Controls_Manager::SLIDER, 'size_units' => [ 'px', '%' ], 'range' => [ 'px' => [ 'min' => -1000, 'max' => 1000, 'step' => 1 ], '%' => [ 'min' => 0, 'max' => 100 ] ], 'default' => [ 'unit' => 'px', 'size' => 2 ], 'selectors' => [ '{{WRAPPER}} .betterdocs-toc > .toc-list a.active:after' => 'top:{{SIZE}}{{UNIT}}!important;', ] ] ); $this->add_responsive_control( 'active_border_left_border_radius', [ 'label' => __( 'Active List Left Border Radius', 'betterdocs' ), 'type' => Controls_Manager::SLIDER, 'size_units' => [ 'px', '%' ], 'range' => [ 'px' => [ 'min' => 0, 'max' => 1000, 'step' => 1 ], '%' => [ 'min' => 0, 'max' => 100 ] ], 'default' => [ 'unit' => 'px', 'size' => 4 ], 'selectors' => [ '{{WRAPPER}} .betterdocs-toc > .toc-list a.active:after' => 'border-radius:{{SIZE}}{{UNIT}}!important;', ] ] ); $this->add_control( 'list_color', [ 'label' => esc_html__( 'List Color', 'betterdocs' ), 'type' => Controls_Manager::COLOR, 'selectors' => [ '{{WRAPPER}} .betterdocs-toc ul li a' => 'color: {{VALUE}};', '{{WRAPPER}} .betterdocs-toc > .toc-list a.active:before' => 'color: {{VALUE}};' ] ] ); $this->add_control( 'list_hover_color', [ 'label' => esc_html__( 'List Hover Color', 'betterdocs' ), 'type' => Controls_Manager::COLOR, 'selectors' => [ '{{WRAPPER}} .betterdocs-toc ul li a:hover' => 'color: {{VALUE}};' ] ] ); $this->add_control( 'list_hover_bg_color', [ 'label' => esc_html__( 'List Hover Background Color', 'betterdocs' ), 'type' => Controls_Manager::COLOR, 'selectors' => [ '{{WRAPPER}} .betterdocs-toc ul li a:hover' => 'background-color: {{VALUE}};' ] ] ); $this->add_responsive_control( 'list_margin', [ 'label' => esc_html__( 'List Item Spacing', 'betterdocs' ), 'type' => Controls_Manager::DIMENSIONS, 'size_units' => [ 'px', 'em', '%' ], 'selectors' => [ '{{WRAPPER}} .betterdocs-toc ul li' => 'margin: {{TOP}}{{UNIT}} {{RIGHT}}{{UNIT}} {{BOTTOM}}{{UNIT}} {{LEFT}}{{UNIT}};' ] ] ); $this->add_responsive_control( 'list_padding', [ 'label' => esc_html__( 'List Wrapper Padding', 'betterdocs' ), 'type' => Controls_Manager::DIMENSIONS, 'size_units' => [ 'px', 'em', '%' ], 'selectors' => [ '{{WRAPPER}} .betterdocs-toc ul' => 'padding: {{TOP}}{{UNIT}} {{RIGHT}}{{UNIT}} {{BOTTOM}}{{UNIT}} {{LEFT}}{{UNIT}}; display: inline-block;' ] ] ); $this->add_responsive_control( 'list_item_padding', [ 'label' => esc_html__( 'List Item Padding', 'betterdocs' ), 'type' => Controls_Manager::DIMENSIONS, 'size_units' => [ 'px', 'em', '%' ], 'selectors' => [ '{{WRAPPER}} .betterdocs-toc ul li a' => 'padding: {{TOP}}{{UNIT}} {{RIGHT}}{{UNIT}} {{BOTTOM}}{{UNIT}} {{LEFT}}{{UNIT}}; display: inline-block;' ] ] ); $this->end_controls_section(); # end of 'Column Settings' } public function render_callback() { $this->views( 'widgets/toc' ); } public function view_params() { $toc_setting = [ 'htags' => $this->attributes['htags'], 'hierarchy' => $this->attributes['list_hierarchy'], 'list_number' => $this->attributes['list_number'] ]; set_transient( 'betterdocs_toc_setting', $toc_setting ); $htags = implode( ',', $this->attributes['htags'] ); $attributes = betterdocs()->template_helper->get_html_attributes( [ 'htags' => $htags, 'hierarchy' => $this->attributes['list_hierarchy'], 'list_number' => $this->attributes['list_number'], 'collapsible_on_mobile' => $this->attributes['collapsible_toc_mobile'], 'toc_title' => $this->attributes['toc_title'] ] ); return [ 'attributes' => $attributes ]; } }