Customizing the layout of the home page

The Redmine home page, also accessible from the first link at the top right of the default Redmine theme, can be customized from inside the system. It can contain links to Redmine tutorials, YouTube videos, your company page, or any kind of Textile/Markdown formatted content.

Getting ready

Make sure that you have Redmine administrator permissions.

How to do it…

Navigate to Administration | Settings | General Tab and edit Welcome text:

Any content entered here will be displayed on the Home page, or when the Home link is clicked. After you enter or edit content, click Save at the bottom of the form, and click the Home link at the top. Your homepage will look like the following screenshot:

The Packt logo and content that we added is visible on the Home page, for all users.

How it works…

Redmine has built-in features to customize the content of the homepage. The home page is publicly visible by visitors if Authentication required is not ticked under Authentication settings. The home page is the first page that the user gets after logging in to Redmine. This recipe utilized the built-in homepage editor to add the Packt publishing logo and some introduction text to the homepage.

There's more…

Additional customizations of the home page could be achieved by editing its view template or theme. You can also customize which page your users get after login through third-party plugins, such as the Landing page plugin, available at http://www.redmine.org/plugins/landing_page. Another plugin worth mentioning is RedmineTweaks, available on https://github.com/alexandermeindl/redmine_tweaks. Once you follow it's installation procedure steps, it can be accessed through Administration | Plugins | Redmine Tweaks | Configure From there, you will be able to customize various other layouts, like Global sidebar, Overview page, add new Menu items to Redmine menus, etc.

See also

Check out the Textile formatting guide from Redmine help.