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

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

153 lines 4.3 KB

Raw Download Zip

1	<?php
2
3	namespace Elementor\Modules\AtomicWidgets\Elements\Atomic_Paragraph;
4
5	use Elementor\Modules\AtomicWidgets\Elements\Base\Atomic_Widget_Base;
6	use Elementor\Modules\AtomicWidgets\Controls\Section;
7	use Elementor\Modules\AtomicWidgets\Controls\Types\Link_Control;
8	use Elementor\Modules\AtomicWidgets\Controls\Types\Select_Control;
9	use Elementor\Modules\AtomicWidgets\Elements\Base\Has_Template;
10	use Elementor\Modules\AtomicWidgets\PropTypes\Classes_Prop_Type;
11	use Elementor\Modules\AtomicWidgets\PropTypes\Attributes_Prop_Type;
12	use Elementor\Modules\AtomicWidgets\PropTypes\Html_V3_Prop_Type;
13	use Elementor\Modules\AtomicWidgets\PropTypes\Link_Prop_Type;
14	use Elementor\Modules\AtomicWidgets\PropTypes\Primitives\String_Prop_Type;
15	use Elementor\Modules\AtomicWidgets\PropTypes\Size_Prop_Type;
16	use Elementor\Modules\AtomicWidgets\Styles\Style_Definition;
17	use Elementor\Modules\AtomicWidgets\Styles\Style_Variant;
18	use Elementor\Modules\AtomicWidgets\Controls\Types\Text_Control;
19	use Elementor\Modules\AtomicWidgets\Controls\Types\Inline_Editing_Control;
20	use Elementor\Modules\Components\PropTypes\Overridable_Prop_Type;
21
22	if ( ! defined( 'ABSPATH' ) ) {
23	exit;
24	}
25
26	class Atomic_Paragraph extends Atomic_Widget_Base {
27	use Has_Template;
28
29	const LINK_BASE_STYLE_KEY = 'link-base';
30
31	public static $widget_description = 'Display a paragraph with customizable tag, styles, and link options.';
32
33	public static function get_element_type(): string {
34	return 'e-paragraph';
35	}
36
37	public function get_title() {
38	return esc_html__( 'Paragraph', 'elementor' );
39	}
40
41	public function get_keywords() {
42	return [ 'ato', 'atom', 'atoms', 'atomic' ];
43	}
44
45	public function get_icon() {
46	return 'eicon-paragraph';
47	}
48
49	protected static function define_props_schema(): array {
50	return [
51	'classes' => Classes_Prop_Type::make()
52	->default( [] ),
53
54	'paragraph' => Html_V3_Prop_Type::make()
55	->default( [
56	'content' => String_Prop_Type::generate( __( 'Type your paragraph here', 'elementor' ) ),
57	'children' => [],
58	] )
59	->description( 'The text content of the paragraph.' )
60	->alias( 'text', 'content' ),
61
62	'tag' => String_Prop_Type::make()
63	->enum( [ 'p', 'span' ] )
64	->default( 'p' ),
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	return [
74	Section::make()
75	->set_label( __( 'Content', 'elementor' ) )
76	->set_id( 'content' )
77	->set_items( [
78	Inline_Editing_Control::bind_to( 'paragraph' )
79	->set_placeholder( __( 'Type your paragraph here', 'elementor' ) )
80	->set_label( __( 'Paragraph', 'elementor' ) ),
81	] ),
82	Section::make()
83	->set_label( __( 'Settings', 'elementor' ) )
84	->set_id( 'settings' )
85	->set_items( $this->get_settings_controls() ),
86	];
87	}
88
89	protected function get_settings_controls(): array {
90	return [
91	Select_Control::bind_to( 'tag' )
92	->set_options([
93	[
94	'value' => 'p',
95	'label' => 'p',
96	],
97	[
98	'value' => 'span',
99	'label' => 'span',
100	],
101	])
102	->set_label( __( 'Tag', 'elementor' ) ),
103	Link_Control::bind_to( 'link' )
104	->set_placeholder( __( 'Type or paste your URL', 'elementor' ) )
105	->set_label( __( 'Link', 'elementor' ) )
106	->set_meta( [
107	'topDivider' => true,
108	] ),
109	Text_Control::bind_to( '_cssid' )
110	->set_label( __( 'ID', 'elementor' ) )
111	->set_meta( $this->get_css_id_control_meta() ),
112	];
113	}
114
115	protected function define_base_styles(): array {
116	$margin_value = Size_Prop_Type::generate( [
117	'unit' => 'px',
118	'size' => 0 ,
119	] );
120
121	return [
122	'base' => Style_Definition::make()
123	->add_variant(
124	Style_Variant::make()
125	->add_prop( 'margin', $margin_value )
126	),
127	self::LINK_BASE_STYLE_KEY => Style_Definition::make()
128	->add_variant(
129	Style_Variant::make()
130	->add_prop( 'all', 'unset' )
131	->add_prop( 'cursor', 'pointer' )
132	),
133	];
134	}
135
136	protected function get_templates(): array {
137	return [
138	'elementor/elements/atomic-paragraph' => __DIR__ . '/atomic-paragraph.html.twig',
139	];
140	}
141
142	public function render_markdown(): string {
143	$settings = $this->get_atomic_settings();
144	$content = $settings['paragraph'] ?? '';
145
146	if ( empty( $content ) ) {
147	return '';
148	}
149
150	return \Elementor\Modules\MarkdownRender\Html_To_Markdown::convert( $content );
151	}
152	}
153