Blocks: Filtered course list

block_filtered_course_list
Maintained by Picture of Kevin Wiliarty Kevin Wiliarty
The Filtered Course List block displays a configurable list of courses. It is intended as a replacement for the My Courses block, although both may be used. It is maintained by the Collaborative Liberal Arts Moodle Project (CLAMP).
334 sites
562 downloads
20 fans

The Filtered Course List block displays a configurable list of courses. It is intended as a replacement for the My Courses block, although both may be used. It is maintained by the Collaborative Liberal Arts Moodle Project (CLAMP).

An administrator can apply various filters by which to organize a user's course listing in the block. Courses can be sorted by category, shortname matches or completion status. If all of the courses in a given semester have a shortname ending in a semester code, for instance, then the administrator can designate those courses to appear under "Current courses," "Future courses" or any other heading. Regex matching is supported.

Administrators can designate multiple collapsible headings and choose which of those headings, if any, should be expanded by default.

Other options include the ability to hide the block from guests or anonymous visitors, to choose whether an admin sees all courses or her own, and to hide or reveal a link to a more comprehensive course search.

Screenshots

Screenshot #0

Contributors

Picture of Kevin Wiliarty
Kevin Wiliarty (Lead maintainer)
Please login to view contributors details and/or to contact them

Comments RSS

Show comments
  • Picture of Faisal Maqsood
    Sun, 19 Nov 2017, 12:16 AM
    Hi,
    I am new to moodle,

    I think i am not getting it how to use it.
    I have tried to write many different ways but its not filtering my category anyhow.

    I just want to use this plugin as:
    Current courses, UpcomingCourses and Ended courses.
    Now how can i show it on frontpage?
    Please guide me as soon as possible because i am stuck at this point from last 2days sad
  • Picture of Kevin Wiliarty
    Mon, 20 Nov 2017, 8:49 PM
    Hello, Faisal, and welcome to the Moodle community. I hope that the initial learning curve will not discourage you. I'll be happy to help you figure out how to use the Filtered Course List block.

    The two basic principles of organization that it can work on are category structure and shortname pattern. Are you going to be putting your courses into categories that correspond to "Current," "Upcoming," and "Completed"? If so, then you can use a category-based strategy. Otherwise, are your course shortnames going to follow a predictable pattern by which you could distinguish the current, upcoming and completed courses? At my institution, for instance, all of the current courses have a shortname that end in "2017F" indicating "Fall 2017." If that is the case then you may prefer to use the shortname matching strategy.

    If you want a list of current, upcoming and completed courses based on the start and end dates in the course, then you probably want to use the native Course Overview instead of the Filtered Course List. The Filtered Course List does not respond to course start and end dates.

    Assuming you want to use the Filtered Course List: Once you have installed the block, you should be able to add an instance of the block anywhere you can add blocks in your Moodle theme. If you are using the Boost theme on Moodle 3.3, for instance, you should see a "Customise this page" button in the upper right on the Dashboard page. When you click that you will see an "Add a block" button at the bottom of the navigation drawer on the left. (I'm assuming left-to-right direction here, so just flip what I'm saying if you need this for a right-to-left layout.) "Filtered course list" should be showing up in that list. Click on it and the block should appear in the column of blocks on the right.

    There are some things to watch out for. If you are logged in but you are not enrolled in any courses, then the block appear. The block shows only the courses a user is enrolled in. If you are looking for a way to let users browse all courses, then you will need a different solution. If you are testing the block as an administrator, make sure that you have enrolled yourself in some courses and that you adjust the block setting for what an admin sees. You need to navigate to Site administration > Plugins > Blocks > Filtered course list. There you can set "Manager view" to "Manager sees own courses."

    Given the situation I mentioned above where the 'current' courses all have shortnames that end in '2017F' I would then put a line like this in the box at the top of the settings page:

    shortname | expanded | Current courses | 2017F

    If my upcoming courses all have shortnames in 2018S then I can add a line like:

    shortname | collapsed | Upcoming courses | 2018S

    Or if you have categories like "Fall 2017" and "Spring 2018" then you can use a configuration line like this:

    category | collapsed | 0 (top level) | 0 (all descendants)

    In that case, though, the block will use the category names, so "Fall 2017" rather than "Current courses". You can of course name a category "Current courses" but then you'll have to be renaming categories as they go in and out of currency.

    I hope this helps. If you have other questions, please let me know and offer a few more details about what you are doing and just where you are getting stuck.

    Cheers,
    Kevin
  • Picture of Dinis Medeiros
    Mon, 22 Jan 2018, 9:23 PM
    Hi
    Thanks for the plugin.
    I'm a translator to Portuguese (PT). I think strings are missing. Am i right?
    https://imgur.com/a/CEcnt
  • Picture of Kevin Wiliarty
    Mon, 22 Jan 2018, 9:51 PM
    Hi Dinis, I'm not aware of any missing strings, but if I've overlooked something please let me know.
  • Picture of Kevin Wiliarty
    Mon, 22 Jan 2018, 9:56 PM
    Hello again Dinis. Just to follow up, I've looked at the screenshot you link to, but I'm puzzled by it. Can you tell me how to get to that interface so that I can examine it more closely?
  • Picture of Kevin Wiliarty
    Mon, 22 Jan 2018, 10:05 PM
    Okay, I can see the problem, too, in the translation site. Not sure why it's not picking up the strings, but I'll investigate and remedy it as soon as I can.
  • Picture of Kevin Wiliarty
    Mon, 22 Jan 2018, 10:20 PM
    The discussion at this link suggests that I need to change the way I have formatted some of my strings. In particular I have some heredoc strings that will need to be replaced. Thanks so much for calling this problem to my attention!
    https://lang.moodle.org/mod/forum/discuss.php?d=2691
  • Picture of Dinis Medeiros
    Tue, 23 Jan 2018, 3:03 AM
    Thanks
  • Picture of Kevin Wiliarty
    Wed, 24 Jan 2018, 12:52 AM
    It took two attempts, but I finally got the strings correctly formatted for AMOS. I confirmed that they are available in the translation interface. Thanks again for your interest in the plugin and for letting me know about the problem. If you have any other questions, please don't hesitate to ask.
  • Picture of Amruta Jamale
    Mon, 5 Mar 2018, 1:48 PM
    Hi Kevin,

    I want that my Filtered course list should display like the following:

    Category 1
    Subcategory 1
    Course 1
    Subcategory 2
    Course 2
    Subcategory 3
    Course 3


    Category 2
    Subcategory 1
    Course 1
    Subcategory 2
    Course 2
    Subcategory 3
    Course 3


    Category 3
    Subcategory 1
    Course 1
    Subcategory 2
    Course 2
    Subcategory 3
    Course 3

    Currently it display like this:
    Subcategory 1
    Subcategory 2
    Subcategory 3
    Subcategory 1
    Subcategory 2
    Subcategory 3
    Subcategory 1
    Subcategory 2
    Subcategory 3
    Can you help me to set the configuration of the filtered block?
  • Picture of Kevin Wiliarty
    Mon, 5 Mar 2018, 10:19 PM
    Hi Amruta,

    The Filtered Course List does not support nested displays per se, but you can perhaps achieve something close to what you are looking for by specifying a "Category rubric template" like this: PARENT > NAME . The uppercase words are tokens that will be replaced in the display by the name of the category parent and then name of the category itself. The separator can be anything you like. PARENT :: NAME would also work, for instance. Then your display should look like this:

    Category 1 > Subcategory 1
    Category 1 > Subcategory 2
    Category 1 > Subcategory 3
    Category 2 > Subcategory 1
    Category 2 > Subcategory 2
    Category 2 > Subcategory 3

    I hope this helps. If you want to follow up, please include your block's configuration and version info. For instance, the "Category rubric template" is only available in relatively recent versions, so I don't know whether you'll have it or not.
  • Patrick Viney au MoodleMoot de Nîmes
    Wed, 6 Jun 2018, 5:14 PM
    Hi, thank you for keeping the precious plugin up to date.
    However, I have a fatal error on my fresh Moodle 3.5 installation when I try to load this page : admin/tool/dataprivacy/pluginregistry.php
    " Fatal error: Interface 'core_privacy\metadata\null_provider' not found in /var/www/html/blocks/filtered_course_list/classes/privacy/provider.php on line 36"
  • Picture of Kevin Wiliarty
    Wed, 6 Jun 2018, 8:21 PM
    Thank you for pointing that out, Patrick. I am able to reproduce the problem. I'll work to fix it as quickly as possible.
  • Picture of Kevin Wiliarty
    Wed, 6 Jun 2018, 8:26 PM
    I've created an issue on the plugin's GitHub repository for this: https://github.com/CLAMP-IT/moodle-blocks_filtered_course_list/issues/108
  • Picture of Kevin Wiliarty
    Thu, 7 Jun 2018, 12:28 AM
    I've just released v3.3.6 to address the problem Patrick Viney pointed out above. Thank you again, Patrick, for calling it to my attention.
1 2 3
Please login to post comments