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

atomic-image.php in Elementor Website Builder – more than just a page builder 4.3.0-beta3, at modules/atomic-widgets/elements/atomic-image/atomic-image.php

139 lines 4.0 KB

Raw Download Zip

1	<?php
2	namespace Elementor\Modules\AtomicWidgets\Elements\Atomic_Image;
3
4	use Elementor\Modules\AtomicWidgets\Controls\Types\Link_Control;
5	use Elementor\Modules\AtomicWidgets\Elements\Base\Has_Template;
6	use Elementor\Modules\AtomicWidgets\PropTypes\Classes_Prop_Type;
7	use Elementor\Modules\AtomicWidgets\PropTypes\Image_Prop_Type;
8	use Elementor\Modules\AtomicWidgets\PropTypes\Link_Prop_Type;
9	use Elementor\Modules\AtomicWidgets\Controls\Section;
10	use Elementor\Modules\AtomicWidgets\Elements\Base\Atomic_Widget_Base;
11	use Elementor\Modules\AtomicWidgets\Elements\Base\Html_Tag_Computer;
12	use Elementor\Modules\AtomicWidgets\PropTypes\Attributes_Prop_Type;
13	use Elementor\Modules\AtomicWidgets\Controls\Types\Image_Control;
14	use Elementor\Modules\AtomicWidgets\Utils\Image\Placeholder_Image;
15	use Elementor\Modules\AtomicWidgets\Styles\Style_Definition;
16	use Elementor\Modules\AtomicWidgets\Styles\Style_Variant;
17	use Elementor\Modules\AtomicWidgets\Controls\Types\Text_Control;
18	use Elementor\Modules\Components\PropTypes\Overridable_Prop_Type;
19
20	if ( ! defined( 'ABSPATH' ) ) {
21	exit; // Exit if accessed directly.
22	}
23
24	class Atomic_Image extends Atomic_Widget_Base {
25	use Has_Template;
26
27	public static $widget_description = 'Display an image with customizable styles and link options.';
28
29	const LINK_BASE_STYLE_KEY = 'link-base';
30	const BASE_STYLE_KEY = 'base';
31
32	public static function get_element_type(): string {
33	return 'e-image';
34	}
35
36	public function get_title() {
37	return esc_html__( 'Image', 'elementor' );
38	}
39
40	public function get_keywords() {
41	return [ 'ato', 'atom', 'atoms', 'atomic', 'image', 'photo', 'picture' ];
42	}
43
44	public function get_icon() {
45	return 'eicon-e-image';
46	}
47
48	public static function html_tag_follows_link(): bool {
49	return false;
50	}
51
52	public static function get_computed_html_tag( array $settings ): string {
53	return Html_Tag_Computer::compute( $settings, 'img', [
54	Html_Tag_Computer::FOLLOW_LINK_OPTION => static::html_tag_follows_link(),
55	] );
56	}
57
58	protected static function define_props_schema(): array {
59	$props = [
60	'classes' => Classes_Prop_Type::make()
61	->default( [] ),
62
63	'image' => Image_Prop_Type::make()
64	->default_url( Placeholder_Image::get_placeholder_image() )
65	->default_size( 'full' ),
66
67	'link' => Link_Prop_Type::make(),
68
69	'attributes' => Attributes_Prop_Type::make()->meta( Overridable_Prop_Type::ignore() ),
70	];
71
72	return $props;
73	}
74
75	protected function define_atomic_controls(): array {
76	return [
77	Section::make()
78	->set_label( esc_html__( 'Content', 'elementor' ) )
79	->set_id( 'content' )
80	->set_items( [
81	Image_Control::bind_to( 'image' )
82	->set_label( __( 'Image', 'elementor' ) ),
83	] ),
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	Link_Control::bind_to( 'link' )
94	->set_placeholder( __( 'Type or paste your URL', 'elementor' ) )
95	->set_label( __( 'Link', 'elementor' ) ),
96	Text_Control::bind_to( '_cssid' )
97	->set_label( __( 'ID', 'elementor' ) )
98	->set_meta( $this->get_css_id_control_meta() ),
99	];
100	}
101
102	protected function define_base_styles(): array {
103	return [
104	self::LINK_BASE_STYLE_KEY => Style_Definition::make()
105	->add_variant(
106	Style_Variant::make()
107	->add_prop( 'all', 'unset' )
108	->add_prop( 'display', 'inherit' )
109	->add_prop( 'width', 'fit-content' )
110	->add_prop( 'cursor', 'pointer' )
111	),
112	self::BASE_STYLE_KEY => Style_Definition::make()
113	->add_variant(
114	Style_Variant::make()
115	->add_prop( 'display', 'block' )
116	),
117	];
118	}
119
120	protected function get_templates(): array {
121	return [
122	'elementor/elements/atomic-image' => __DIR__ . '/atomic-image.html.twig',
123	];
124	}
125
126	public function render_markdown(): string {
127	$settings = $this->get_atomic_settings();
128	$src = $settings['image']['src'] ?? '';
129
130	if ( empty( $src ) ) {
131	return '';
132	}
133
134	$alt = $settings['image']['alt'] ?? '';
135
136	return '![' . $alt . '](' . esc_url( $src ) . ')';
137	}
138	}
139