# Add New Finder Items

Elementor Core Basic

For each new item (link) we add to the finder, we need to define several fields. This includes the label, the URL, the icon, etc. All these links are grouped together in an array and returned together.

# New Category

Finder categories include all the category labels and their items.

class New_Finder_Category extends \Elementor\Core\Common\Modules\Finder\Base_Category {

	public function get_id() {
		return 'my-category-name';
	}

	public function get_title() {
		return esc_html__( 'Category Label', 'plugin-name' );
	}

	public function get_category_items( array $options = [] ) {
		return [
			'elementor-website' => [
				'title' => esc_html__( 'Elementor', 'plugin-name' ),
				'icon' => 'elementor',
				'url' => 'https://elementor.com/',
				'keywords' => [ 'elementor', 'website' ],
			],
			'wordpress-website' => [
				'title' => esc_html__( 'WordPress', 'plugin-name' ),
				'icon' => 'wordpress',
				'url' => 'https://wordpress.org/',
				'keywords' => [ 'wordpress', 'website' ],
			],
		];
	}

}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28

Each item has to include the following properties:

  • name – Used to define the ID in the $items array (Required).
  • title – Used to define the label displayed to the user (Required).
  • icon – Used to define the icon displayed before the title/label.
  • url – Used to define the URL (Required).
  • keywords – Used to define relevant search keywords.

# Registering a Finder Category

When the finder category class is ready, we must add it to the categories manager. This is done using the elementor/finder/register action hook.

When adding a new category, we need to provide the class itself, with this code:

function register_new_finder_category( $finder_categories_manager ) {

	$finder_categories_manager->register( new New_Finder_Category() );

};
add_action( 'elementor/finder/register', 'register_new_finder_category' );
1
2
3
4
5
6