This page in other versions: master
The Forge homepage is divided in two main divs. On top, the default header, then the main page. This top header includes the following elements:
- Forge headermenu (1)
- Quick Jump Menu, if user is logged and is member of a project. (2)
- Search Menu (3)
- Forge outermenu (4)
The project menu is described in the dedicated page: Project homepage
The second part is the main page that can be either a PHP page or widget oriented.
- Login/Logout facility. See User login page for detail.
- New account: require to set the configuration flag user_registration_restricted to no (default value). Link to register user page
- My account: require to be logged. Link to User account page
Quick Jump Menu
This menu is dynamically generated by using the project memberships of the user and the permission settings of the user within each project the user belongs to, i.e: having administrative permissions on some tools of a project or on a project, the menu will include Admin entry.
Using the configuration use_quicknav_default flag adjusts the included project in the quick jump menu based on the frequency of pages within project membership to select the 5 top used projects and limit the size of the quick jump menu to these 5 projects.
Any entry in this menu is a quick link to the selected section. Plugins provide also entry in this menu.
The search menu is dynamically generated. From the Forge Homepage, you can search for:
More information about Search menu here.
- Home: point to the Forge homepage.
- My page: if connected, point to the User personal homepage, else redirect to the authentication mechanism.
- Projects: point to the project categorization: tag cloud, project tree using trove, project list
- Code Snippets:
- Project Openings:
- Site admin: requires forge admin permission
- Reporting: requires forge admin permission
- Project Name tab: dynamically created if user is browsing a page of the project.
New entries in this submenu can be added using the Headermenu plugin. It requires forge admin permission.
2 options to customize the Forge homepage.
- use a custom PHP page
- use the Widget System and select layout & widgets to display
Use PHP page
By default, FusionForge uses the index_std.php file shipped with the FusionForge version. This file located in source_path/www/ can be overwritten by creating a new file index_std.php in the folder defined as custom_path value in the configuration core section.
A more complex solution is to overwrite the inclusion of the index_std.php directly in the theme mechanism.
Both solutions require PHP/html skills.
Use Widget System
To use widgets on Forge Homepage, it requires to turn on the configuration flag forge_homepage_widget in the core section.
Available widgets per category
- file release system
Default activated widgets: