(MODX)EvolutionCMS.plugins.ddManagerFavorites

Manager plugin: favorite files/folders tab in the left tree.

• Plugin creates a tab in the Manager left menu, next to the documents tree.
• Add any files/folders to favorites.
• List is automatically sorted alphabetically.
• Favorites under a favorited folder are grouped into a nested tree:
  • Children show a path relative to that folder.
  • Within a group, files come before nested folders.
  • If a folder has 2 or more direct children (a file or a nested folder), an auto folder is created (and removed when fewer than two children remain).
    • For example, manually added:
      • assets/modules/
      • assets/plugins/ddManagerFavorites/ddManagerFavorites.js
      • assets/plugins/ddManagerFavorites/tpl/item.html
      • assets/plugins/ddManagerFavorites/tpl/tab.html
      • assets/snippets/ddRunSnippets/src/Snippet.php
    • Result:
      • assets/ — auto folder
        • modules/ — folder added manually
        • plugins/ddManagerFavorites/ — auto folder
          • ddManagerFavorites.js
          • tpl/ — auto folder
            • item.html
            • tab.html
        • snippets/ddRunSnippets/src/Snippet.php
  • Removing a favorited folder also removes all favorites nested under it.
• Click opens file edit (with focus on textarea) or folder view.
• Removed favorites can be viewed in trash (toolbar button) and restored.
• Favorites are stored in the browser (in localStorage), to avoid overloading the database (write in the support chat, if you prefer the database, we will think about this).

Requires

• PHP >= 7.4
• (MODX)EvolutionCMS >= 1.4
• (MODX)EvolutionCMS.libraries.ddTools >= 0.69
• jQuery >= 1.11.1 (Manager already provides it)
• jQuery.ddTools >= 4.2.1 (shipped with the plugin)

Installation

Using (MODX)EvolutionCMS.libraries.ddInstaller

Just run the following PHP code in your sources or Console:

// Include (MODX)EvolutionCMS.libraries.ddInstaller
require_once(
	$modx->getConfig('base_path')
	. 'assets/libs/ddInstaller/require.php'
);

// Install (MODX)EvolutionCMS.plugins.ddManagerFavorites
\DDInstaller::install([
	'url' => 'https://github.com/DivanDesign/EvolutionCMS.plugins.ddManagerFavorites',
]);

• If ddManagerFavorites is not exists on your site, ddInstaller will just install the plugin.
• If ddManagerFavorites is already exists on your site, ddInstaller will check it version and update it if needed.
• After installation, set the system event OnManagerTreeRender in the plugin settings (ddInstaller does not yet support events).

Manually

1. Elements → Plugins: Create a new plugin with the following data

1. Plugin name: ddManagerFavorites.
2. Description: <b>1.1</b> Manager favorite files/folders tab..
3. Category: Core → Manager.
4. Parse DocBlock: no.
5. Plugin code (php): Insert content of the ddManagerFavorites_plugin.php file from the archive.
6. System Events: OnManagerTreeRender.

2. Elements → Manage Files

1. Create a new folder assets/plugins/ddManagerFavorites/.
2. Extract the archive to the folder (except ddManagerFavorites_plugin.php).

Links

• Telegram chat
• Packagist
• GitHub