elementor / includes / widgets / read-more.php

read-more.php in Elementor Website Builder – more than just a page builder 3.19.0-beta1, at includes/widgets/read-more.php

154 lines 3.2 KB

Raw Download Zip

1	<?php
2	namespace Elementor;
3
4	if ( ! defined( 'ABSPATH' ) ) {
5	exit; // Exit if accessed directly.
6	}
7
8	/**
9	* Elementor HTML widget.
10	*
11	* Elementor widget that insert a custom HTML code into the page.
12	*
13	*/
14	class Widget_Read_More extends Widget_Base {
15
16	/**
17	* Get widget name.
18	*
19	* Retrieve Read More widget name.
20	*
21	* @since 2.4.0
22	* @access public
23	*
24	* @return string Widget name.
25	*/
26	public function get_name() {
27	return 'read-more';
28	}
29
30	/**
31	* Get widget title.
32	*
33	* Retrieve Read More widget title.
34	*
35	* @since 2.4.0
36	* @access public
37	*
38	* @return string Widget title.
39	*/
40	public function get_title() {
41	return esc_html__( 'Read More', 'elementor' );
42	}
43
44	/**
45	* Get widget icon.
46	*
47	* Retrieve Read More widget icon.
48	*
49	* @since 2.4.0
50	* @access public
51	*
52	* @return string Widget icon.
53	*/
54	public function get_icon() {
55	return 'eicon-post-excerpt';
56	}
57
58	/**
59	* Get widget keywords.
60	*
61	* Retrieve the list of keywords the widget belongs to.
62	*
63	* @since 2.4.0
64	* @access public
65	*
66	* @return array Widget keywords.
67	*/
68	public function get_keywords() {
69	return [ 'read', 'more', 'tag', 'excerpt' ];
70	}
71
72	/**
73	* Register HTML widget controls.
74	*
75	* Adds different input fields to allow the user to change and customize the widget settings.
76	*
77	* @since 3.1.0
78	* @access protected
79	*/
80	protected function register_controls() {
81	$this->start_controls_section(
82	'section_title',
83	[
84	'label' => esc_html__( 'Read More', 'elementor' ),
85	]
86	);
87
88	$default_link_text = esc_html__( 'Continue reading', 'elementor' );
89
90	/**
91	* Read More widgets link text.
92	*
93	* Filters the link text in the "Read More" widget.
94	*
95	* This hook can be used to set different default text in the widget.
96	*
97	* @param string $default_link_text The link text in the "Read More" widget. Default is "Continue reading".
98	*/
99	$default_link_text = apply_filters( 'elementor/widgets/read_more/default_link_text', $default_link_text );
100
101	$this->add_control(
102	'theme_support',
103	[
104	'type' => Controls_Manager::RAW_HTML,
105	'raw' => sprintf(
106	/* translators: %s: The `the_content` function. */
107	esc_html__( 'Note: This widget only affects themes that use `%s` in archive pages.', 'elementor' ),
108	'the_content'
109	),
110	'content_classes' => 'elementor-panel-alert elementor-panel-alert-warning',
111	]
112	);
113
114	$this->add_control(
115	'link_text',
116	[
117	'label' => esc_html__( 'Read More Text', 'elementor' ),
118	'placeholder' => $default_link_text,
119	'default' => $default_link_text,
120	'dynamic' => [
121	'active' => true,
122	],
123	]
124	);
125
126	$this->end_controls_section();
127	}
128
129	/**
130	* Render Read More widget output on the frontend.
131	*
132	* Written in PHP and used to generate the final HTML.
133	*
134	* @access protected
135	*/
136	protected function render() {
137	printf( '<!--more %s-->', wp_kses_post( $this->get_settings_for_display( 'link_text' ) ) );
138	}
139
140	/**
141	* Render Read More widget output in the editor.
142	*
143	* Written as a Backbone JavaScript template and used to generate the live preview.
144	*
145	* @since 2.9.0
146	* @access protected
147	*/
148	protected function content_template() {
149	?>
150	<!--more {{ settings.link_text }}-->
151	<?php
152	}
153	}
154