Note: This documentation is for Moodle 2.7. For up-to-date documentation see Front page settings.

Front page settings: Difference between revisions

From MoodleDocs
m (Text replacement - "class="nicetable"" to "class="wikitable"")
 
(86 intermediate revisions by 25 users not shown)
Line 1: Line 1:
{{Front page}}
{{Front page}}The site's [[Front page]] is similar to a course page. The front page settings, roles, filters, backup, restore and questions are currently duplicated in ''Administration> Front page settings'' AND ''Settings > Site administration > Front page'' (reported as MDL-26012).
Location: ''Site administration > Front Page > Front Page settings''


==Front page settings==


The site's [[Front Page]] is similar to a course page, however the settings are located in the site administration block.  Some of the Front Page settings impact the entire site.
The following settings may be changed by a site administrator in ''Administration > Front page settings > Edit settings'':
 
 
==Settings==


===Full site name===
===Full site name===
Line 15: Line 12:
The short name appears at the beginning of the navigation bar as a link back to your site front page.
The short name appears at the beginning of the navigation bar as a link back to your site front page.


===Front page description===
===Front page summary===
An optional setting enabling you to add short message to your users in a block on the front page.
This summary can be displayed on the front page using the course/site summary block.


===Front page and front page items when logged in===
===Front page and Front page items when logged in===
The centre of the front page can display any combination of the following: news items, a list of courses, a list of course categories, a list of categories and courses or none.  The order is determined by a combination box.  
The centre of the front page can display any combination of the following: news items, a list of courses, a list of enrolled courses, a list of course categories, a list of categories and courses, a course search box or none.  The order is determined by a combination box.  


It is possible to create one setting for anyone who gets to the front page without logging in to the Moodle site, and another look for only those who have logged into the Moodle site.  There are two combination boxes
It is possible to create one setting for anyone who gets to the front page without logging in to the Moodle site, and another look for only those who have logged into the Moodle site.  There are two combination boxes.




{| class="nicetable"
{| class="wikitable"
|-
|-
!colspan="3"|Combination boxes
!colspan="3"|Combination boxes
Line 34: Line 31:
   
   


:An alternative option for logged-in users is [[My Moodle]].
:An alternative option for logged-in users is [[My home]] (can be set in Site administration > Appearance > Navigation)
|[[Image:FrontPage_settings_frontpageloggedin.png|thumb|right|frontpage for login user box]]
|[[Image:FrontPage_settings_frontpageloggedin.png|thumb|right|frontpage for login user box]]
|}
|}


===Maximum Category Depth===
===Maximum category depth===
Determines how many sub categories will be displayed on the front page for each category.
This specifies the maximum depth of child categories expanded when displaying categories or combo list. Deeper level categories will appear as links and user can expand them with AJAX request.
 
===Maximum number of courses===
Maximum number of courses to be displayed on the site's front page in course listings.


===Include a topic section===
===Include a topic section===
Line 49: Line 49:
This setting only applies if the front page is set to display news items or if you are using the [[Latest News block]].
This setting only applies if the front page is set to display news items or if you are using the [[Latest News block]].


===Comments Per Page===
===Comments per page===
A new setting for Moodle 2. Each course may include a [[Comments block]] which allows the display of user comments. The number of comments displayed at any time is set here.
Each course may include a [[Comments block]] which allows the display of user comments. The number of comments displayed at any time is set here.
 
===Default front page role===


===Courses per page===
The default frontpage role enables logged-in users to participate in front page activities. It is recommended that it is set to frontpage role. It should ''never'' be set to [[Guest]].
Limits the number of courses which will display on a page.


===Allow visible courses in hidden categories===
For sites which do not have a default frontpage role (because they upgraded from 1.9), it is recommended that the administrator [[Creating custom roles|creates a new role]] with frontpage archetype, resets it to default and then sets it as the default frontpage role.
Do you want to display courses which are not hidden but placed in a category that is hidden?


===Default front page role===
==Front Page roles==
To enable logged-in users to participate in front page activities, a default front page role can be set. In Moodle 2, there is an Authenticated User on Front Page Role to which specific permissions can be granted for specific purposes. Alternatively, more than one [[Create_custom_roles|Custom Role]] can be created to offer a number of different options for Admins to use in a variety of combinations that provide a great deal more flexibility on the Front Page.  
As in a course, you can assign users [[Roles|roles]] just in the [[Context|context]] of this page.  Note this is different from the default Authenticated User on Front Page role found in front page settings. As a security issue, usually only admins can modify the front page, other users do not.
 
It is possible to upload users as students in the front page with a csv file using the site short name as 'course1' field, student in 'role1' field (and, if needed, chosen group name in 'group1' field.)
 
==Front Page backup==
You can backup the front page, similar to a [[Course backup]].
 
==Front Page restore==
As in a course, you can [[Restore]] a backed up version of the front page.
However, there are currently issues with front page restore, as outlined in MDL-31500 and MDL-30808
 
==Front Page questions==
The [[Question bank]] is accessible from the Front Page. For example, if "topic" is checked in the front page settings, you can add a [[Quiz module]] activity.
 
==Tips and Tricks==
 
A Moodle site's front page can be reconfigured from the default standard to give it a different look and or change how it functions.  Depending upon the changes, this can be a simple or a more complex process. See [[Front page FAQ]] for some ideas on customising your front page.
====Visual examples====
<gallery caption="Guest view, same Theme- click on any to enlarge" widths="150px" heights="100px" perrow="3">
Image:fp013col.png|3 column Front Page, topic checked
Image:fp032colright.png|2 column Front Page, blocks right
Image:fp022colleft.png|2 column Front Pageblocks left
Image:fp043coluser.png|3 column Front Page, Categories and courses
Image:fp052colright.png|2 column Front Page, Categories only
Image:fp021col.png|Clean look, topic checked, no blocks
</gallery>
 
====Central area, Courses or Categories?====
This is a major decision, what is it you want in the centre of your front page? You can have a list of categories, a list of categories and courses, or neither, a label with a table full of images works just as well. The issue is always the same, actually, what looks good.
 
====Clean look, topic checked, no blocks====
The standard Moodle page format of [[Block]]s on the left and blocks on the right is not always appropriate or considered pretty. The [[Administrator|site administrator]] can change this basic format by simply deleting or hiding blocks that can be seen by users. Navigation can be placed on the dock.
 
====The two column format====
The Administrator decides which blocks should appear on the front page and moves all of them to the left or right side. This format allows you to decide what you want in the centre, and where you want the blocks, left or right. 
:Tip: It is possible to force a block column to assume a specific width.  For example, placing an image of 400 px in a block will force that column to 400 px.
 
====The clean look example====
Some sites want an uncluttered look. A site administrator or designer wants to start with the most basic look and then add features.
 
# The site administrator will turn on editing and hide or delete all blocks that can be see by teachers or students on the front page.
# Then go to the Site administration block► Front Page ► Front Page settings and:
## Set the "Front page" list to None, None, None, None
## Set "Front page items when logged in" list to the same
## Check the box for "Include Topic section"
## Save
 
All the above was done with 1 theme, and a simple front page.
 
If you're using a theme such as Clean or More (standard in 2.7 onwards) you can then do some cool things with Bootstrap layout elements, as described in the thread [https://moodle.org/mod/forum/discuss.php?d=267662 LOOK & LEARN: How to add marketing spots as a front page topic].
 
==Block settings==
[[Image:Editconfigblock.png|thumb|200px|right|Editing block settings]]
Each block has a number of configuration settings that you can change. See [[Managing blocks]] for more details.


:Note: The default Front Page role should ''never'' be set to [[Guest]].
==Other settings that change the look of the Main Page==
Some components of the Main Page, such as the logo, heading and Navigation bar may be changed by an administrator in '' Administration > Site administration >  Appearance > Themes '' and clicking on the theme name. Different themes may have fewer or more options to set. There are some other settings available in  '' Administration > Site administration >  Appearance > Themes > Theme settings ''.


==See also==
==See also==
*[[Front Page FAQ]]
*[[Front Page FAQ]]
*Using Moodle [http://moodle.org/mod/forum/discuss.php?d=73448 Front page activities] forum discussion
*[http://youtu.be/XkVp4Vo0juA Moodle 2 Administration Front page settings] MoodleBites video on YouTube
 
[[Category:Front Page]]
[[Category:Administrator]]


[[Category:Site administration]]


[[de:Einstellungen_f%C3%BCr_die_Startseite]]
[[de:Einstellungen_f%C3%BCr_die_Startseite]]
[[es:Configuraciones de la portada]]
[[eu:Hasiera-orriaren_ezarpenak]]
[[eu:Hasiera-orriaren_ezarpenak]]
[[fr:Réglages page d'accueil]]
[[fr:Réglages page d'accueil]]
[[pl:Ustawienia strony głównej]]
[[pl:Ustawienia strony głównej]]

Latest revision as of 15:18, 10 August 2021

The site's Front page is similar to a course page. The front page settings, roles, filters, backup, restore and questions are currently duplicated in Administration> Front page settings AND Settings > Site administration > Front page (reported as MDL-26012).

Front page settings

The following settings may be changed by a site administrator in Administration > Front page settings > Edit settings:

Full site name

This name appears at the top of every page above the navigation bar.

Front page full site name

Short name for site

The short name appears at the beginning of the navigation bar as a link back to your site front page.

Front page summary

This summary can be displayed on the front page using the course/site summary block.

Front page and Front page items when logged in

The centre of the front page can display any combination of the following: news items, a list of courses, a list of enrolled courses, a list of course categories, a list of categories and courses, a course search box or none. The order is determined by a combination box.

It is possible to create one setting for anyone who gets to the front page without logging in to the Moodle site, and another look for only those who have logged into the Moodle site. There are two combination boxes.


Combination boxes
frontpage showing pulldown
The image on the left shows the first Front Page settings dialog - what visitors will see before they log in.

The image on the right shows a second front Page settings dialog - what Authenticated Users will see when logged in.


An alternative option for logged-in users is My home (can be set in Site administration > Appearance > Navigation)
frontpage for login user box

Maximum category depth

This specifies the maximum depth of child categories expanded when displaying categories or combo list. Deeper level categories will appear as links and user can expand them with AJAX request.

Maximum number of courses

Maximum number of courses to be displayed on the site's front page in course listings.

Include a topic section

This adds a topic section to the centre-top of the front page. When editing is turned on, resources and/or activities can be added to the topic section using the dropdown menus, in the same way as on a course page.

Note: The label resource can be used to add text and/or an image to the centre-top of the front page.

News items to show

This setting only applies if the front page is set to display news items or if you are using the Latest News block.

Comments per page

Each course may include a Comments block which allows the display of user comments. The number of comments displayed at any time is set here.

Default front page role

The default frontpage role enables logged-in users to participate in front page activities. It is recommended that it is set to frontpage role. It should never be set to Guest.

For sites which do not have a default frontpage role (because they upgraded from 1.9), it is recommended that the administrator creates a new role with frontpage archetype, resets it to default and then sets it as the default frontpage role.

Front Page roles

As in a course, you can assign users roles just in the context of this page. Note this is different from the default Authenticated User on Front Page role found in front page settings. As a security issue, usually only admins can modify the front page, other users do not.

It is possible to upload users as students in the front page with a csv file using the site short name as 'course1' field, student in 'role1' field (and, if needed, chosen group name in 'group1' field.)

Front Page backup

You can backup the front page, similar to a Course backup.

Front Page restore

As in a course, you can Restore a backed up version of the front page. However, there are currently issues with front page restore, as outlined in MDL-31500 and MDL-30808

Front Page questions

The Question bank is accessible from the Front Page. For example, if "topic" is checked in the front page settings, you can add a Quiz module activity.

Tips and Tricks

A Moodle site's front page can be reconfigured from the default standard to give it a different look and or change how it functions. Depending upon the changes, this can be a simple or a more complex process. See Front page FAQ for some ideas on customising your front page.

Visual examples

Central area, Courses or Categories?

This is a major decision, what is it you want in the centre of your front page? You can have a list of categories, a list of categories and courses, or neither, a label with a table full of images works just as well. The issue is always the same, actually, what looks good.

Clean look, topic checked, no blocks

The standard Moodle page format of Blocks on the left and blocks on the right is not always appropriate or considered pretty. The site administrator can change this basic format by simply deleting or hiding blocks that can be seen by users. Navigation can be placed on the dock.

The two column format

The Administrator decides which blocks should appear on the front page and moves all of them to the left or right side. This format allows you to decide what you want in the centre, and where you want the blocks, left or right.

Tip: It is possible to force a block column to assume a specific width. For example, placing an image of 400 px in a block will force that column to 400 px.

The clean look example

Some sites want an uncluttered look. A site administrator or designer wants to start with the most basic look and then add features.

  1. The site administrator will turn on editing and hide or delete all blocks that can be see by teachers or students on the front page.
  2. Then go to the Site administration block► Front Page ► Front Page settings and:
    1. Set the "Front page" list to None, None, None, None
    2. Set "Front page items when logged in" list to the same
    3. Check the box for "Include Topic section"
    4. Save

All the above was done with 1 theme, and a simple front page.

If you're using a theme such as Clean or More (standard in 2.7 onwards) you can then do some cool things with Bootstrap layout elements, as described in the thread LOOK & LEARN: How to add marketing spots as a front page topic.

Block settings

Editing block settings

Each block has a number of configuration settings that you can change. See Managing blocks for more details.

Other settings that change the look of the Main Page

Some components of the Main Page, such as the logo, heading and Navigation bar may be changed by an administrator in Administration > Site administration > Appearance > Themes and clicking on the theme name. Different themes may have fewer or more options to set. There are some other settings available in Administration > Site administration > Appearance > Themes > Theme settings .

See also