Widgets: Add widget promotions (#252)

src/controls/complex-example.md

@@ -274,19 +274,6 @@ class Elementor_Test_Widget extends \Elementor\Widget_Base {
 		return 'eicon-code';
 	}
 
-	/**
-	 * Get custom help URL.
-	 *
-	 * Retrieve a URL where the user can get more information about the widget.
-	 *
-	 * @since 1.0.0
-	 * @access public
-	 * @return string Widget help URL.
-	 */
-	public function get_custom_help_url() {
-		return 'https://developers.elementor.com/docs/widgets/';
-	}
-
 	/**
 	 * Get widget categories.
 	 *
@@ -313,6 +300,19 @@ class Elementor_Test_Widget extends \Elementor\Widget_Base {
 		return [ 'test', 'emoji' ];
 	}
 
+	/**
+	 * Get custom help URL.
+	 *
+	 * Retrieve a URL where the user can get more information about the widget.
+	 *
+	 * @since 1.0.0
+	 * @access public
+	 * @return string Widget help URL.
+	 */
+	public function get_custom_help_url() {
+		return 'https://developers.elementor.com/docs/widgets/';
+	}
+
 	/**
 	 * Register test widget controls.
 	 *

src/controls/simple-example.md

@@ -251,19 +251,6 @@ class Elementor_Currency_Widget extends \Elementor\Widget_Base {
 		return 'eicon-cart-medium';
 	}
 
-	/**
-	 * Get custom help URL.
-	 *
-	 * Retrieve a URL where the user can get more information about the widget.
-	 *
-	 * @since 1.0.0
-	 * @access public
-	 * @return string Widget help URL.
-	 */
-	public function get_custom_help_url() {
-		return 'https://developers.elementor.com/docs/widgets/';
-	}
-
 	/**
 	 * Get widget categories.
 	 *
@@ -290,6 +277,19 @@ class Elementor_Currency_Widget extends \Elementor\Widget_Base {
 		return [ 'currency', 'currencies' ];
 	}
 
+	/**
+	 * Get custom help URL.
+	 *
+	 * Retrieve a URL where the user can get more information about the widget.
+	 *
+	 * @since 1.0.0
+	 * @access public
+	 * @return string Widget help URL.
+	 */
+	public function get_custom_help_url() {
+		return 'https://developers.elementor.com/docs/widgets/';
+	}
+
 	/**
 	 * Register currency widget controls.
 	 *

src/widgets/advanced-example.md

@@ -115,19 +115,6 @@ class Elementor_List_Widget extends \Elementor\Widget_Base {
 		return 'eicon-bullet-list';
 	}
 
-	/**
-	 * Get custom help URL.
-	 *
-	 * Retrieve a URL where the user can get more information about the widget.
-	 *
-	 * @since 1.0.0
-	 * @access public
-	 * @return string Widget help URL.
-	 */
-	public function get_custom_help_url() {
-		return 'https://developers.elementor.com/docs/widgets/';
-	}
-
 	/**
 	 * Get widget categories.
 	 *
@@ -154,6 +141,40 @@ class Elementor_List_Widget extends \Elementor\Widget_Base {
 		return [ 'list', 'lists', 'ordered', 'unordered' ];
 	}
 
+	/**
+	 * Get custom help URL.
+	 *
+	 * Retrieve a URL where the user can get more information about the widget.
+	 *
+	 * @since 1.0.0
+	 * @access public
+	 * @return string Widget help URL.
+	 */
+	public function get_custom_help_url() {
+		return 'https://developers.elementor.com/docs/widgets/';
+	}
+
+	/**
+	 * Get widget promotion data.
+	 *
+	 * Retrieve the widget promotion data.
+	 *
+	 * @since 1.0.0
+	 * @access protected
+	 * @return array Widget promotion data.
+	 */
+	protected function get_upsale_data() {
+		return [
+			'condition' => true,
+			'image' => esc_url( ELEMENTOR_ASSETS_URL . 'images/go-pro.svg' ),
+			'image_alt' => esc_attr__( 'Upgrade', 'elementor-list-widget' ),
+			'title' => esc_html__( 'Promotion heading', 'elementor-list-widget' ),
+			'description' => esc_html__( 'Get the premium version of the widget with additional styling capabilities.', 'elementor-list-widget' ),
+			'upgrade_url' => esc_url( 'https://example.com/upgrade-to-pro/' ),
+			'upgrade_text' => esc_html__( 'Upgrade Now', 'elementor-list-widget' ),
+		];
+	}
+
 	/**
 	 * Register list widget controls.
 	 *
@@ -195,7 +216,6 @@ class Elementor_List_Widget extends \Elementor\Widget_Base {
 			[
 				'label' => esc_html__( 'Link', 'elementor-list-widget' ),
 				'type' => \Elementor\Controls_Manager::URL,
-				'placeholder' => esc_html__( 'https://your-link.com', 'elementor-list-widget' ),
 				'dynamic' => [
 					'active' => true,
 				],

src/widgets/simple-example.md

@@ -115,19 +115,6 @@ class Elementor_oEmbed_Widget extends \Elementor\Widget_Base {
 		return 'eicon-code';
 	}
 
-	/**
-	 * Get custom help URL.
-	 *
-	 * Retrieve a URL where the user can get more information about the widget.
-	 *
-	 * @since 1.0.0
-	 * @access public
-	 * @return string Widget help URL.
-	 */
-	public function get_custom_help_url() {
-		return 'https://developers.elementor.com/docs/widgets/';
-	}
-
 	/**
 	 * Get widget categories.
 	 *
@@ -154,6 +141,19 @@ class Elementor_oEmbed_Widget extends \Elementor\Widget_Base {
 		return [ 'oembed', 'url', 'link' ];
 	}
 
+	/**
+	 * Get custom help URL.
+	 *
+	 * Retrieve a URL where the user can get more information about the widget.
+	 *
+	 * @since 1.0.0
+	 * @access public
+	 * @return string Widget help URL.
+	 */
+	public function get_custom_help_url() {
+		return 'https://developers.elementor.com/docs/widgets/';
+	}
+
 	/**
 	 * Register oEmbed widget controls.
 	 *

src/widgets/widget-data.md

@@ -23,10 +23,6 @@ class Elementor_Test_Widget extends \Elementor\Widget_Base {
 		return 'eicon-code';
 	}
 
-	public function get_custom_help_url() {
-		return 'https://go.elementor.com/widget-name';
-	}
-
 	public function get_categories() {
 		return [ 'general' ];
 	}
@@ -35,6 +31,14 @@ class Elementor_Test_Widget extends \Elementor\Widget_Base {
 		return [ 'keyword', 'keyword' ];
 	}
 
+	public function get_custom_help_url() {
+		return 'https://go.elementor.com/widget-name';
+	}
+
+	protected function get_upsale_data() {
+		return [];
+	}
+
 }
 ```
 
@@ -44,8 +48,10 @@ class Elementor_Test_Widget extends \Elementor\Widget_Base {
 
 * **Widget Icon** – The `get_icon()` method is an optional, but recommended, method. It lets you set the widget icon. You can use any [Elementor icons](https://elementor.github.io/elementor-icons/) or [FontAwesome icons](https://fontawesome.com/), to simply return the CSS class name.
 
-* **Widget Help URL** – The `get_custom_help_url()` method is an optional method that sets a custom URL, where the user can get more information about the widget, below the controls.
-
 * **Widget Categories** – The `get_categories()` method lets you set [the category of the widget](./widget-categories/).
 
 * **Widget Keywords** – The `get_keywords()` method lets you set widget keywords and is used to filter the widget list.
+
+* **Widget Help URL** – The `get_custom_help_url()` method is an optional method that sets a custom URL, where the user can get more information about the widget, below the controls.
+
+* **Widget Promotion** – The `get_upsale_data()` method is an optional method that is used to display promotions at the bottom of the widget panel.

src/widgets/widget-structure.md

@@ -28,12 +28,14 @@ class Elementor_Test_Widget extends \Elementor\Widget_Base {
 
 	public function get_icon() {}
 
-	public function get_custom_help_url() {}
-
 	public function get_categories() {}
 
 	public function get_keywords() {}
 
+	public function get_custom_help_url() {}
+
+	protected function get_upsale_data() {
+
 	public function get_script_depends() {}
 
 	public function get_style_depends() {}