GettingStarted

Getting Started

Once you have installed the Asset Manager (see Installation), you can start using it immediately. Just create or edit a standard MODX page and you should see the "Assets" tab.

---

In the Manager

Uploading Assets

Asset Manager implements the Dropzone.js library to allow for a streamlined drag-and-drop interface for adding images and files to your pages. Drag and drop a file from your computer onto the dropzone labeled "Drop files here", or click the "Select Files" button to launch the traditional file-selection dialog box.

Once you have dropped the files (or selected them), upload begins. Once completed, the asset's thumbnail will appear. You can click any thumbnail to view or edit the asset's details.

Editing Assets

You can click on any asset thumbnail on the Assets tab to edit it. This will cause a modal window to open up where you can change an asset's title and alternate description. The "Group" field is used to group assets on a page. See the getPageAssets Snippet.

Reordering Assets

To change the order of the assets, drag and drop them into the desired order and then save the page. Remember: some edits are only saved when you save the page. Other edits are saved when you save the modal window.

Deleting Assets

To delete an asset, drag its thumbnail to the trash icon on the "Assets" tab. You will be prompted to confirm the deletion.

Remove from Page: this will remove the asset from the current page. This option will preserve the original file and other pages will not be affected.

Delete: This will delete the file from the filesystem and delete the corresponding record(s) from the database. Be careful: if you have used an asset on more than one page, then deleting the asset will remove it from all pages.

---

In Your Templates

Once you have uploaded assets to your pages, you will quickly want to see the fruits of your labor on the front-end. You will need to use Snippets to display the assets. See the Snippets section in the menu at the right.