admin/setting/moodletxtfilters

Note: This article is a work in progress. Please use the page comments or an appropriate moodle.org forum for any recommendations/suggestions for improvement.

Managing Inbound Filters in MoodleTxt

This form uses a step-by-step process to edit the filters in place, and add new ones. Firstly, select the ConnectTxt account within the system you wish to apply filters on from the drop-down labelled "Available ConnectTxt accounts". You will see the word "Loading" appear underneath for a short period whilst MoodleTxt loads the existing filter structure for that account.

Note: In terms of filtering, ConnectTxt accounts are independent of one another. It is quite possible to have the same keyword filter on several different accounts, routing messages to different users. Similarly, it is possible to set up one keyword across all accounts that is always filtered to the same user.

Once the "Loading" message has disappeared, the two lists of existing filters will be populated and unlocked. You now have two options.

1) To edit an existing filter on the system, select it from either the keyword or phone number filter list. You will see another loading message while the details of that particular filter are pulled out of the database. When this disappears, you should be able to see the filter's recipients in the large select box underneath.

2) To create a new filter, click the "Create New" link to the right of either the keyword or phone number filter lists, depending on which you wish to create. The filter list will be replaced with a text box. In this box you enter the operand for your new filter – that is the keyword or phone number on which you wish to filter messages. Once you have done this, the large recipient list underneath should be unlocked.

You have now specified the filter you wish to edit. Below the two filter options on the page is a larger select box. This box holds a list of all the recipients specified for a particular filter. For a new filter, this will be blank, and for an existing filter, it will show the list of previously selected recipients for that filter.

To add a new recipient to a filter, locate the textbox labelled "Add users to filter". This is an auto-completing search box. As you type in it, it searches the Moodle database for the user you are looking for and displays possible selections onscreen. You can search by either first name, last name or username. For example, typing "Pre" into our MoodleTxt test server would display "Preece, Greg (admin)".

Once the user you are looking for is displayed, select them by either highlighting them with the arrow keys and hitting return, or by clicking on them with the mouse. You should see the user being added to the recipient list.

To remove a recipient from a filter, select them from the recipients list and click the "Remove selected users from filter" button below it. They will be immediately removed from the recipients list. You can remove multiple users at the same time by either holding CTRL to select multiple individual entries, or holding SHIFT to select a consecutive group.

Once the filter has been edited/created to your satisfaction, and the recipients list appears correct, click the "Save the filter" button at the bottom of the form, and it will be saved back to the database. If you have removed all recipients from an existing filter, then that filter will also be deleted once the recipients have been removed.