Note: You are currently viewing documentation for Moodle 2.8. Up-to-date documentation for the latest stable version of Moodle may be available here: Collapsed Topics course format.

Collapsed Topics course format: Difference between revisions

From MoodleDocs
No edit summary
Line 60: Line 60:
* 'Day' - where each section is presented as a day in ascending day order from the start date of the course.
* 'Day' - where each section is presented as a day in ascending day order from the start date of the course.


== Fine tuning the look ==
== Settings ==
 
'''Formatting'''


Most of the formatting is contained within the file 'topics_collapsed.css' which is fully commented to facilitate easy manipulation of specific elements.  For example, if you found that in your particular web browser the 'Topic ''x'' ' text was too big...
'''Collapsed Topics specific settings'''


The format's settings are accessed through the 'settings' icon that appears in editing mode:


[[Image:Collapsed topics image2.png|center|Topic text too big]]
[[Image:ct23_settings|center|Settings]]


which gives the form:


Then you can change the 'font-size:0.7em;' in the '.course-content ul.ctopics li.section .content .toggle a' selector class in the 'styles.css' file:
[[Image:ct23_settings_form|center|Settings Form]]


 
where you can change on a per course basis various elements like not displaying the 'Toggle' word.  Note: The 'reset all' functionality is only available to administrators.
[[Image:ct_23_font.png|center|Changing the css]]


'''Per Course Colours'''
'''Per Course Colours'''


You can set a different look on a per course basis by changing the format's settings (using the 'settings' icon that appears top right in editing mode):
You can set a different look on a per course basis by changing the format's settings (using the 'settings' icon):


[[Image:ct23_colour.png|center|Per course colours]]
[[Image:ct23_colour.png|center|Per course colours]]


If you wish to use the same colours in all new courses then set the colour values in the 'config.php' file in the format's folder.  To have all collapsed topics courses use the same colours, tick 'Reset colours for all Collapsed Topics courses' as shown in the screen shot above.
If you wish to use the same colours in all new courses then set the colour values in the 'config.php' file in the format's folder.  To have all collapsed topics courses use the same colours, tick 'Reset colours for all Collapsed Topics courses' as shown in the screen shot above.
'''Columns'''
In the settings form you can choose between one to four columns for the layout:
[[Image:ct23_columns_settings.png|center|Per course column settings]]
which in this example gives:
[[Image:ct23_columns.png|center|Per course columns]]
== Fine tuning the look ==
'''Formatting'''
Most of the formatting is contained within the file 'styles.css' which is fully commented to facilitate easy manipulation of specific elements.  For example, if you found that in your particular web browser the 'Topic ''x'' ' text was too big...
[[Image:Collapsed topics image2.png|center|Topic text too big]]
Then you can change the 'font-size:0.7em;' in the '.course-content ul.ctopics li.section .content .toggle a' selector class:
[[Image:ct_23_font.png|center|Changing the css]]


'''The Arrow'''
'''The Arrow'''

Revision as of 12:55, 3 September 2012

The Collapsed Topics course format is a contributed code module. The format is similar to the standard Topics format except that all topics (except '0') can be 'toggled' on and off. This reduces clutter in courses that have a large number of topics, lots of content in the topics or a combination of the two.

Collapsed Topics format example


Download

You can download the format from the Modules and Plugins Database or by going to GitHub and cloning the repository alternatively by selecting one of the downloads for your version of Moodle if the database is unavailable. Full installation instructions are in the included 'Readme.txt' file.

Installing

Please follow the instructions in the supplied 'Readme.txt' file and if desired, follow this video:

<mediaplayer>http://www.youtube.com/watch?v=ydFdES-pKYc</mediaplayer>

Usage

Selecting

To select the format, simply choose it from the list of course formats in the course settings. To show / hide a topic just click on its toggle.

Course Format


Setting the Toggle Text

Tick off 'Use default section name' and type in the 'Section name' box. This allows the summary to be shown as it normally is in the Topics course format (Course_homepage#Topic_format_example).

Summary description Moodle 2.2


Toggle State

When refreshing the page, the state of the 'toggles' is remembered. This is on a per browser session per course basis for as long as the browser remains open. If you would like it to persist longer, please follow the instructions in the included 'Readme.txt' file.

Changing the look

Introduction

Since versions 1.9.8.1, 2.0.5.1, 2.1.5.1, 2.2.3.1 and 2.3.3.1 for Moodle 1.9.14+, 2.0.5+, 2.1.2+, 2.2+ and 2.3+ respectively, which were released on the 5th March 2012 the format now incorporates a means of customising the 'elements' and 'structure' of the course within Moodle on a course by course basis. The 'elements' are such things as the 'Toggle' word showing / not showing. The 'structure' is the way the sections are presented, in effect the ability to switch to the 'Collapsed Weeks' format without installing another course format. Two other structures 'Latest Week First' and 'Current Topic First' have also been added.

Demonstration

For a demonstration of this enhancement, please see the 'Collapsed Topics course format new structure' video:

<mediaplayer>http://www.youtube.com/watch?v=gvo-OseVKr8</mediaplayer>

Structure descriptions

  • 'Topics' - Where each section is presented as a topic in section number order. This is identical to previous versions of the format.
  • 'Weeks' - Where each section is presented as a week in ascending week order. This is identical to the 'Collapsed Weeks' course format.
  • 'Latest Week First' - The same as 'Weeks' but the current week is shown at the top and preceding weeks in decending order are displayed below execpt in editing mode where the structure is the same as 'Weeks'.
  • 'Current Topic First' - The same as 'Topics' except that the current topic is shown at the top if it has been set.
  • 'Day' - where each section is presented as a day in ascending day order from the start date of the course.

Settings

Collapsed Topics specific settings

The format's settings are accessed through the 'settings' icon that appears in editing mode:

which gives the form:

where you can change on a per course basis various elements like not displaying the 'Toggle' word. Note: The 'reset all' functionality is only available to administrators.

Per Course Colours

You can set a different look on a per course basis by changing the format's settings (using the 'settings' icon):

Per course colours

If you wish to use the same colours in all new courses then set the colour values in the 'config.php' file in the format's folder. To have all collapsed topics courses use the same colours, tick 'Reset colours for all Collapsed Topics courses' as shown in the screen shot above.

Columns

In the settings form you can choose between one to four columns for the layout:

Per course column settings

which in this example gives:

Per course columns


Fine tuning the look

Formatting

Most of the formatting is contained within the file 'styles.css' which is fully commented to facilitate easy manipulation of specific elements. For example, if you found that in your particular web browser the 'Topic x ' text was too big...

Topic text too big

Then you can change the 'font-size:0.7em;' in the '.course-content ul.ctopics li.section .content .toggle a' selector class:

Changing the css

The Arrow

If you want to change the look and style of the arrow, simply change 'arrow_down.png' and 'arrow_up.png'.

FAQ

Q. How do I report an issue with Collapsed Topics?

A. Raise an issue on Moodle Tracker or post a discussion on the Moodle Course Formats Forum

Q. Is Collapsed Topics Moodle 2.0, Moodle 2.1 & Moodle 2.2 compatible?

A. Yes. It incorporates a change where the section name of the topic summary is used instead of the summary itself to form the words on the toggle.

Credits

Collapsed Topics has been developed by and is maintained by Gareth Barnard with invaluable input from:

See also