{exp:assets:folders}¶
You can use the {exp:assets:folders} tag pair to loop through folders managed by Assets.
<ul>
{exp:assets:folders}
<li>
<a href="{path=assets/view/{folder_id}}">{folder_name}</a>
{if total_subfolders > 0}
<ul>
{subfolders}
</ul>
{/if}
</li>
{/exp:assets:folders}
</ul>
Tag Parameters¶
{exp:assets:folders} supports the following parameters:
- parent_folder
- The path of the parent folder whose subfolders you wish to output. Set this parameter in the format of either “{filedir_X}optional/subfolder/path” or “{source_X}optional/subfolder/path”.
- parent_id
- The ID of the parent folder whose subfolders you wish to output. If this both this parameter and parent_folder parameter is omitted, Assets will loop through all of your EE upload directories and S3 buckets.
- keywords
- A pipe-delimited list of keywords to filter the folders by.
- recursive
- If this is set to “yes”, all nested folders will be returned as well. (Set to “no” by default.)
- offset
- Skips the first X folders
- limit
- Limits the number of folders to be returned
- sort
- Sorts the results. Can be set to “desc” or “random”.
Variable Tags¶
{exp:assets:folders} supports the following variable tags:
- {folder_id}
- The ID that Assets has assigned to the current folder.
- {folder_name}
- The name of the current folder.
- {depth}
- The depth of the current folder. Top-level sources’ depth are ‘0’, first-level subfolders’ depth are ‘1’, their subfolders’ depth are ‘2’, and so on.
- {total_subfolders}
- The total number of subfolders the current folder has.
- {subfolders}
- If this tag is present, it will get replaced with the entire {exp:assets:folders} tag pair’s template code, including the {subfolders} tag. This provides a way to recursively output your entire folder tree (see example below).
- {parent_id}
- The ID of the current folder’s parent folder.