elementor / includes / widgets / read-more.php

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

158 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	protected function is_dynamic_content(): bool {
73	return false;
74	}
75
76	/**
77	* Register HTML widget controls.
78	*
79	* Adds different input fields to allow the user to change and customize the widget settings.
80	*
81	* @since 3.1.0
82	* @access protected
83	*/
84	protected function register_controls() {
85	$this->start_controls_section(
86	'section_title',
87	[
88	'label' => esc_html__( 'Read More', 'elementor' ),
89	]
90	);
91
92	$default_link_text = esc_html__( 'Continue reading', 'elementor' );
93
94	/**
95	* Read More widgets link text.
96	*
97	* Filters the link text in the "Read More" widget.
98	*
99	* This hook can be used to set different default text in the widget.
100	*
101	* @param string $default_link_text The link text in the "Read More" widget. Default is "Continue reading".
102	*/
103	$default_link_text = apply_filters( 'elementor/widgets/read_more/default_link_text', $default_link_text );
104
105	$this->add_control(
106	'theme_support',
107	[
108	'type' => Controls_Manager::ALERT,
109	'alert_type' => 'warning',
110	'content' => sprintf(
111	/* translators: %s: The `the_content` function. */
112	esc_html__( 'Note: This widget only affects themes that use `%s` in archive pages.', 'elementor' ),
113	'the_content'
114	),
115	]
116	);
117
118	$this->add_control(
119	'link_text',
120	[
121	'label' => esc_html__( 'Read More Text', 'elementor' ),
122	'placeholder' => $default_link_text,
123	'default' => $default_link_text,
124	'dynamic' => [
125	'active' => true,
126	],
127	]
128	);
129
130	$this->end_controls_section();
131	}
132
133	/**
134	* Render Read More widget output on the frontend.
135	*
136	* Written in PHP and used to generate the final HTML.
137	*
138	* @access protected
139	*/
140	protected function render() {
141	printf( '<!--more %s-->', wp_kses_post( $this->get_settings_for_display( 'link_text' ) ) );
142	}
143
144	/**
145	* Render Read More widget output in the editor.
146	*
147	* Written as a Backbone JavaScript template and used to generate the live preview.
148	*
149	* @since 2.9.0
150	* @access protected
151	*/
152	protected function content_template() {
153	?>
154	<!--more {{ settings.link_text }}-->
155	<?php
156	}
157	}
158