elementor / modules / atomic-widgets / elements / atomic-heading / atomic-heading.php

atomic-heading.php in Elementor Website Builder – more than just a page builder 4.2.0-beta2, at modules/atomic-widgets/elements/atomic-heading/atomic-heading.php

188 lines 5.0 KB

Raw Download Zip

1	<?php
2	namespace Elementor\Modules\AtomicWidgets\Elements\Atomic_Heading;
3
4	use Elementor\Modules\AtomicWidgets\Controls\Section;
5	use Elementor\Modules\AtomicWidgets\Controls\Types\Inline_Editing_Control;
6	use Elementor\Modules\AtomicWidgets\Controls\Types\Link_Control;
7	use Elementor\Modules\AtomicWidgets\Controls\Types\Select_Control;
8	use Elementor\Modules\AtomicWidgets\Controls\Types\Text_Control;
9	use Elementor\Modules\AtomicWidgets\Elements\Base\Atomic_Widget_Base;
10	use Elementor\Modules\AtomicWidgets\Elements\Base\Has_Template;
11	use Elementor\Modules\AtomicWidgets\PropTypes\Attributes_Prop_Type;
12	use Elementor\Modules\AtomicWidgets\PropTypes\Classes_Prop_Type;
13	use Elementor\Modules\AtomicWidgets\PropTypes\Html_V3_Prop_Type;
14	use Elementor\Modules\AtomicWidgets\PropTypes\Link_Prop_Type;
15	use Elementor\Modules\AtomicWidgets\PropTypes\Primitives\String_Prop_Type;
16	use Elementor\Modules\AtomicWidgets\PropTypes\Size_Prop_Type;
17	use Elementor\Modules\AtomicWidgets\Styles\Style_Definition;
18	use Elementor\Modules\AtomicWidgets\Styles\Style_Variant;
19	use Elementor\Modules\Components\PropTypes\Overridable_Prop_Type;
20
21	if ( ! defined( 'ABSPATH' ) ) {
22	exit; // Exit if accessed directly.
23	}
24
25	class Atomic_Heading extends Atomic_Widget_Base {
26	use Has_Template;
27
28	const LINK_BASE_STYLE_KEY = 'link-base';
29
30	public static $widget_description = 'Display a heading with customizable tag, styles, and link options.';
31
32	public static function get_element_type(): string {
33	return 'e-heading';
34	}
35
36	public function get_title() {
37	return esc_html__( 'Heading', 'elementor' );
38	}
39
40	public function get_keywords() {
41	return [ 'ato', 'atom', 'atoms', 'atomic' ];
42	}
43
44	public function get_icon() {
45	return 'eicon-e-heading';
46	}
47
48	protected static function define_props_schema(): array {
49	return [
50	'classes' => Classes_Prop_Type::make()
51	->default( [] ),
52
53	'tag' => String_Prop_Type::make()
54	->enum( [ 'h1', 'h2', 'h3', 'h4', 'h5', 'h6' ] )
55	->default( 'h2' )
56	->description( 'The HTML tag for the heading element. Could be h1, h2, up to h6' ),
57
58	'title' => Html_V3_Prop_Type::make()
59	->default( [
60	'content' => String_Prop_Type::generate( __( 'This is a title', 'elementor' ) ),
61	'children' => [],
62	] )
63	->description( 'The text content of the heading.' )
64	->alias( 'text', 'content', 'heading' ),
65
66	'link' => Link_Prop_Type::make(),
67
68	'attributes' => Attributes_Prop_Type::make()->meta( Overridable_Prop_Type::ignore() ),
69	];
70	}
71
72	protected function define_atomic_controls(): array {
73	$content_section = Section::make()
74	->set_label( __( 'Content', 'elementor' ) )
75	->set_id( 'content' )
76	->set_items( [
77	Inline_Editing_Control::bind_to( 'title' )
78	->set_placeholder( __( 'Type your title here', 'elementor' ) )
79	->set_label( __( 'Title', 'elementor' ) ),
80	] );
81
82	return [
83	$content_section,
84	Section::make()
85	->set_label( __( 'Settings', 'elementor' ) )
86	->set_id( 'settings' )
87	->set_items( $this->get_settings_controls() ),
88	];
89	}
90
91	protected function get_settings_controls(): array {
92	return [
93	Select_Control::bind_to( 'tag' )
94	->set_options([
95	[
96	'value' => 'h1',
97	'label' => 'H1',
98	],
99	[
100	'value' => 'h2',
101	'label' => 'H2',
102	],
103	[
104	'value' => 'h3',
105	'label' => 'H3',
106	],
107	[
108	'value' => 'h4',
109	'label' => 'H4',
110	],
111	[
112	'value' => 'h5',
113	'label' => 'H5',
114	],
115	[
116	'value' => 'h6',
117	'label' => 'H6',
118	],
119	])
120	->set_label( __( 'Tag', 'elementor' ) ),
121	Link_Control::bind_to( 'link' )
122	->set_placeholder( __( 'Type or paste your URL', 'elementor' ) )
123	->set_label( __( 'Link', 'elementor' ) )
124	->set_meta( [
125	'topDivider' => true,
126	] ),
127	Text_Control::bind_to( '_cssid' )
128	->set_label( __( 'ID', 'elementor' ) )
129	->set_meta( $this->get_css_id_control_meta() ),
130	];
131	}
132
133	protected function define_base_styles(): array {
134	$margin_value = Size_Prop_Type::generate( [
135	'unit' => 'px',
136	'size' => 0 ,
137	] );
138
139	return [
140	'base' => Style_Definition::make()
141	->add_variant(
142	Style_Variant::make()
143	->add_prop( 'margin', $margin_value )
144	),
145	self::LINK_BASE_STYLE_KEY => Style_Definition::make()
146	->add_variant(
147	Style_Variant::make()
148	->add_prop( 'all', 'unset' )
149	->add_prop( 'cursor', 'pointer' )
150	),
151	];
152	}
153
154	protected function get_templates(): array {
155	return [
156	'elementor/elements/atomic-heading' => __DIR__ . '/atomic-heading.html.twig',
157	];
158	}
159
160	public function render_markdown(): string {
161	$settings = $this->get_atomic_settings();
162	$title = wp_strip_all_tags( $settings['title'] ?? '' );
163
164	if ( empty( $title ) ) {
165	return '';
166	}
167
168	$tag = $settings['tag'] ?? 'h2';
169	$level_map = [
170	'h1' => 1,
171	'h2' => 2,
172	'h3' => 3,
173	'h4' => 4,
174	'h5' => 5,
175	'h6' => 6,
176	];
177	$level = $level_map[ $tag ] ?? 2;
178
179	$md = str_repeat( '#', $level ) . ' ' . $title;
180
181	if ( ! empty( $settings['link']['href'] ) ) {
182	$md = str_repeat( '#', $level ) . ' [' . $title . '](' . esc_url( $settings['link']['href'] ) . ')';
183	}
184
185	return $md;
186	}
187	}
188