Advanced
Custom Collections
Create and manage custom Icon Collections.
Extending YOOtheme Pro
The following guide assumes you are already familar with code, PHP, and extending YOOtheme Pro.
Add Collection
Adding a custom collection is simple as placing the collection in media/yooessentials/icons/mycollection
for Joomla or wp-content/yooessentials/icons/mycollection
for WordPress. The collection will be automatically picked up and displayed among other collections in the icons picker modal.
You can group the icons into subfolders for a better organization or style separation, eg mycollection/group-a
or mycollection/group-b
.
Notice that a collection name cannot contain hyphens -
, while a group name doesn't have such limitation.
Distribute Collections
If you have many projects relying on the same collections or you would like to distribute your collections among other projects, it is advisable to wrap those collections in a YOOtheme Pro module which you can place in a Child Theme or a plugin.
Place all collections inside the module and register it folder by extending the Icons
service in the bootstrap.php
file.
// bootstrap.php
<?php
use ZOOlanders\YOOessentials\Icons;
return [
'extend' => [
Icons::class => function (Icons $icons, $app) {
$icons->addCollectionsDir('/path/to/collections');
}
]
];