FTL templates and descriptions reference

Here's a list of the FTL files you can customize when creating your custom theme. Each FTL file corresponds to a part of the user interface.

To add text or HTML markup to the blog actions sidebar, you add it to template/blogs/view-sidebar.ftl. These files are listed in the Admin Console when you're editing a custom theme.

Note: Not all of the listed teplates have descriptions. If you've used one of the templates and it's not described here, feel free to add its description — and correct those that might be wrong!

Generally, the templates are divided by content type, such as whether they are the basis for blog-, document-, or discussion-related pages. Global templates apply to multiple content types.

Decorators

FTL template file	UI component
/template/decorator/default/print.ftl	Print page
/template/decorator/default/template.ftl	Default decorator
/template/decorator/setup/template.ftl	Setup wizard decorator

Global

FTL template file	UI component
/template/global/account-success.ftl	Displayed after creating a user account.
/template/global/addressbook.ftl	Address book page.
/template/global/announce-form.ftl	Form for creating an announcement.
/template/global/avatar-settings.ftl	Page for setting one's avatar.
/template/global/change-password.ftl	Password change page.
/template/global/community.ftl	Community main page.
/template/global/community-breadcrumbs.ftl
/template/global/community-everywhere-content.ftl	UI for displaying "community everywhere" content.
/template/global/community-feeds.ftl	Displays feeds available for the community.
/template/global/content-picker.ftl	Insert Link UI.
/template/global/create-account.ftl	Create Your Account: Registration page.
/template/global/create-profile.ftl	Create profile UI.
/template/global/custom-css.ftl	The string added when a custom-css.ftl file is created.
/template/global/create-account.ftl
/template/global/edit-profile.ftl	Page for editing a user profile.
/template/global/email-password.ftl	Form for requesting a password reset.
/template/global/error.ftl	Error page.
/template/global/guest-preferences.ftl	Page for guests to edit their settings.
/template/global/help.ftl	Help page.
/template/global/image-picker.ftl	Insert Image page. (Not yet used.)
/template/global/image-picker-close.ftl	Success page for inserting an image. (Not yet used.)
/template/global/include/community-picker.ftl
/template/global/include/doctype-picker.ftl	Page to choose a document type.
/template/global/include/edit-profile-rows.ftl	Page section through which to edit profile values.
/template/global/include/form-message.ftl
/template/global/include/group-chat.ftl
/template/global/include/help-markup-syntax.ftl	Plain text markup help page.
/template/global/include/incoming-links.ftl	Incoming Links sidebar.
/template/global/include/jive-macros.ftl	Collects common functions.
/template/global/include/license-macros.ftl
/template/global/include/more-like-this.ftl	More Like This sidebar.
/template/global/include/profile-field-attributes.ftl
/template/global/include/rate.ftl	Presents stars for rating content and displaying the average rating.
/template/global/include/recent-history.ftl	Recent History page.
/template/global/include/status-level-leaders.ftl	Top Contributors sidebar.
/template/global/include/tag-cloud.ftl	Popular Tags and Your Commonly Used Tags sidebars.
/template/global/include/user-content.ftl	More by <user> sidebar.
/template/global/include/view-markup-syntax.ftl	Containing markup for plain text markup help page.
/template/global/include/view-profile-fields.ftl	User profile details box.
/template/global/include/view-profile-header.ftl	User name and tabs from user profile page.
/template/global/initialize-error.ftl	Error message when the application can't be initialized.
/template/global/login.ftl	User Login page.
/template/global/main-blogposts.ftl	Main list of blog posts.
/template/global/main-documents.ftl	Main list of documents.
/template/global/main-threads.ftl	Main list of discussions.
/template/global/opensearch.ftl
/template/global/people.ftl	The page at /people.
/template/global/people-autocomplete.ftl
/template/global/pm-folders.ftl
/template/global/pm-main.ftl
/template/global/pm-postform.ftl
/template/global/pm-view.ftl
/template/global/poll.ftl	Page listing polls in a particular community.
/template/global/poll-form.ftl	Page for creating or editing a poll.
/template/global/recent-updates.ftl
/template/global/registration-unavailable.ftl
/template/global/reset-password.ftl	Reset Password page.
/template/global/search.ftl	Search page.
/template/global/tag.ftl	"Tag: <tag_name>" page.
/template/global/tag-set-create.ftl	Create Tag Group page.
/template/global/tags.ftl	Tags browse page.
/template/global/user-bar.ftl	User bar \-\- the row of menus at the top of each page.
/template/global/user-preferences.ftl	Your Settings page for user preferences.
/template/global/validate.ftl
/template/global/view-profile.ftl	Main user profile page.
/template/global/view-profile-blogposts.ftl	User profile page with Blog Posts tab displayed.
/template/global/view-profile-discussions.ftl	User profile page with Discussions tab displayed.
/template/global/view-profile-documents.ftl	User profile page with Documents tab displayed.
/template/global/view-profile-short.ftl	User profile page with Profile tab displayed.
/template/global/view-profile-watches.ftl	User profile page with Email Notifications tab displayed.

Blogs

FTL template file	UI component
/template/blogs/blog-macros.ftl	Includes blog-related summaries, such as recent posts and comments.
/template/blogs/blogs-admin-picker.ftl	Choose a blog to manage.
/template/blogs/view-blog.ftl	The page at /blogs/<blog_name>
/template/blogs/view-blog-cloud.ftl	The page at /blogs/<blog_name>/tags
/template/blogs/view-blog-cloud-sidebar.ftl
/template/blogs/view-blog-day.ftl	The page at /blogs/<blog_name>/<year>/<month_number>/<date>
/template/blogs/view-blog-feeds.ftl	The page at /blogs/<blog_name>/feeds
/template/blogs/view-blog-month.ftl	The page at /blogs/<blog_name>/<year>/<month_number>
/template/blogs/view-blog-post.ftl	A blog post page.
/template/blogs/view-blog-year.ftl	The page at /blogs/<blog_name>/<year>
/template/blogs/view-blogs.ftl	The page at /blogs/browse
/template/blogs/view-blogs-cloud.ftl	The page at /blogs/tags
/template/blogs/view-blogs-feeds.ftl	The page at /blogs/feeds
/template/blogs/view-sidebar.ftl	Blog actions sidebar

Documents

FTL template file	UI component
/template/docs/community-document-picker.ftl	"New Document" page on which to choose a document type.
/template/docs/doc-authors.ftl	The page at /docs/<doc_id>/authors
/template/docs/doc-collaborate.ftl	The page at /docs/<doc_id>/collaborate
/template/docs/doc-create.ftl	The page at /docs/<doc_id>/create
/template/docs/doc-create-image-inline.ftl	The page displayed when a new document is created.
/template/docs/doc-create-image-login.ftl	Login redirect page.
/template/docs/doc-create-spell.ftl	Unused.
/template/docs/doc-create-spell-success.ftl	Unused.
/template/docs/doc-create-valerror.ftl	Unused.
/template/docs/doc-create-vererror.ftl	Displayed when multiple users edit a document at the same time.
/template/docs/doc-move.ftl	"Move Document" page.
/template/docs/doc-upload.ftl	Unused.
/template/docs/doc-version.ftl	The page at /docs/<doc_id>/version
/template/docs/document.ftl	The document view page.
/template/docs/document-diff.ftl	Version Comparison page for a document.
/template/docs/include/doc-macros.ftl
/template/docs/include/doc-needs-approval.ftl	Box displaying document approve/reject message.
/template/docs/include/user-picker.ftl	Popup page through which to search for a user.
/template/docs/user-approval-documents.ftl	UI displaying documents pending approval by the user.
/template/docs/your-documents.ftl

Discussions

FTL template file	UI component
/template/forums/community-thread-picker.ftl
/template/forums/include/forum-macros.ftl
/template/forums/message-abuse.ftl	Report Abuse page.
/template/forums/message-view.ftl	Page for viewing a discussion message thread.
/template/forums/moderation.ftl
/template/forums/postform.ftl	Page for posting or replying to a discussion thread.
/template/forums/postform-success.ftl
/template/forums/question-markas.ftl
/template/forums/question-resolve.ftl
/template/forums/question-unmarkas.ftl
/template/forums/thread.ftl
/template/forums/thread-branch.ftl
/template/forums/thread-delete.ftl
/template/forums/thread-lock.ftl
/template/forums/thread-move.ftl
/template/forums/thread-unlock.ftl

Related

Custom themes advanced topics