MoodleDocs - User contributions [en]

Collaborate

2016-09-06T20:42:10Z

Psychoph:

A module for integration with Blackboard Collaborate.

Now your users can join a Collaborate with the Ultra experience session from their Moodle class. They don't need to install Java or download and open Java-reliant files to their devices. The session opens in a new window or tab, depending on a their browser settings.

When you install and enable the module, your instructors can add Collaborate to their classes. They can create virtual classrooms, offices, and meeting spaces to engage their students in a more collaborative and interactive learning experience.

Visit [https://en-us.help.blackboard.com/Moodlerooms/Administrator/020_Manage_a_Site/050_External_Tools/010_Blackboard_Collaborate Blackboard's Help documentation on Collaborate] for more information

Collaborate

2016-09-06T20:40:43Z

Psychoph:

A module for integration with Blackboard Collaborate.

Now your users can join a Collaborate with the Ultra experience session from their Moodle class. They don't need to install Java or download and open Java-reliant files to their devices. The session opens in a new window or tab, depending on a their browser settings.

When you install and enable the module, your instructors can add Collaborate to their classes. They can create virtual classrooms, offices, and meeting spaces to engage their students in a more collaborative and interactive learning experience.

To learn more, see https://en-us.help.blackboard.com/Moodlerooms/Administrator/020_Manage_a_Site/050_External_Tools/010_Blackboard_Collaborate.

Plugin types

2015-08-25T18:45:54Z

Psychoph:

{{Plugins development}}

The M in Moodle stands for modular. The easiest and most maintainable way to add new functionality to Moodle is by writing one of these types of plugin.
If none of the standardized types fits your needs, you can use the "local" type.

{| class="nicetable"
|-
! Plugin type
! Component name
! Moodle path
! Description
! Moodle versions
|-
| [[Activity modules]]
| mod
| /mod
| Activity modules are the most important type of plugins. They provide activities in courses. For example: Forum, Quiz and Assignment.
| All
|-
| [[Admin reports]]
| report
| /admin/report
| Provides useful views of data in a Moodle site, for admins only.
| Up to 2.1 (for 2.2+ see [[Reports]])
|-
| [[Admin tools]]
| tool
| /admin/tool
| Provides utility scripts useful for admins to examine and modify a Moodle site
| 2.2+
|-
| [[Assignment types|Assignment 2.2 types]]
| assignment
| /mod/assignment/type
| Different forms of assignments to be graded by teachers
| 1.x - 2.2
|-
| [[Assign_submission_plugins|Assignment 2.3 submissions]]
| assignsubmission
| /mod/assign/submission
| Different forms of assignment submissions
| 2.3+
|-
| [[Assign_feedback_plugins|Assignment 2.3 feedbacks]]
| assignfeedback
| /mod/assign/feedback
| Different forms of assignment feedbacks
| 2.3+
|-
| [[Atto|Atto editor plugin]]
| atto
| /lib/editor/atto/plugins
| Extra functionality for the Atto text editor
| 2.7+
|-
| [[Authentication plugins]]
| auth
| /auth
| Allows connection to external sources of authentication
| 2.0+
|-
| [[Availability conditions]]
| availability
| /availability/condition
| Conditions to restrict user access to activities and sections.
| 2.7+ (proposed)
|-
| [[Book tool]]
| booktool
| /mod/book/tool
| Small information-displays or tools that can be moved around pages
| ???
|-
| [[Blocks]]
| block
| /blocks
| Small information-displays or tools that can be moved around pages
| 2.0+
|-
| [[Cache store]]
| cachestore
| /cache/stores
| Cache storage back-ends.
| 2.4+
|-
| [[Cache locks]]
| cachelock
| /cache/locks
| Cache lock implementations.
| 2.4+
|-
| [[Calendar types]]
| calendartype
| /calendar/type
| Defines how dates are displayed throughout Moodle
| 2.6+
|-
| [[Course formats]]
| format
| /course/format
| Different ways of laying out the activities and blocks in a course
| 1.3+
|-
| [[Course reports]]
| coursereport
| /course/report
| Reports of activity within the course
| Up to 2.1 (for 2.2+ see [[Reports]])
|-
| [[Database fields]]
| datafield
| /mod/data/field
| Different types of data that may be added to the Database activity module
| 1.6+
|-
| [[Database presets]]
| datapreset
| /mod/data/preset
| Pre-defined templates for the Database activity module
| 1.6+
|-
| [[Editors]]
| editor
| /lib/editor
| Alternative text editors for editing content
| 2.0+
|-
| [[Enrolment plugins]]
| enrol
| /enrol
| Ways to control who is enrolled in courses
| 2.0+
|-
| [[External tool source]]
| ltisource
| /mod/lti/source
| LTI providers can be added to external tools easily through the external tools interface see [https://docs.moodle.org/en/External_tool Documentation on External Tools]. This type of plugin is specific to LTI providers that need a plugin that can register custom handlers to process LTI messages
| 2.7+
|-
| [[Filters]]
| filter
| /filter
| Automatically convert, highlight, and transmogrify text posted into Moodle.
| 1.4+
|-
| [[Gradebook export]]
| gradeexport
| /grade/export
| Export grades in various formats
| 1.9+
|-
| [[Gradebook import]]
| gradeimport
| /grade/import
| Import grades in various formats
| 1.9+
|-
| [[Gradebook reports]]
| gradereport
| /grade/report
| Display/edit grades in various layouts and reports
| 1.9+
|-
| [[Grading methods]]
| gradingform
| /grade/grading/form
| Interfaces for actually performing grading in activity modules (eg Rubrics).
| 2.2+
|-
| [[Local plugins]]
| local
| /local
| Generic plugins for local customisations
| 2.0+
|-
| [[Messaging consumers]]
| message
| /message/output
| Send messages to users via different methods (email, sms, jabber, etc)
| 2.0+
|-
| [[Plagiarism plugins]]
| plagiarism
| /plagiarism
| Define external services to process submitted files and content
| 2.0+
|-
| [[Portfolio plugins]]
| portfolio
| /portfolio
| Connect external portfolio services as destinations for users to store Moodle content
| 1.9+
|-
| [[Question behaviours]]
| qbehaviour
| /question/behaviour
| Control how student interact with questions during an attempt
| 2.1+
|-
| [[Question formats]]
| qformat
| /question/format
| Import and export question definitions to/from the question bank
| 1.6+
|-
| [[Question types]]
| qtype
| /question/type
| Different types of question (e.g. multiple-choice, drag-and-drop) that can be used in quizzes and other activities
| 1.6+
|-
| [[Quiz access rules]]
| quizaccess
| /mod/quiz/accessrule
| Add conditions to when or where quizzes can be attempted, for example only from some IP addresses, or student must enter a password first
| 2.2+
|-
| [[Quiz reports]]
| quiz
| /mod/quiz/report
| Display and analyse the results of quizzes, or just plug miscellaneous behaviour into the quiz module
| 1.1+
|-
| [[Reports]]
| report
| /report
| Provides useful views of data in a Moodle site for admins and teachers
| 2.2+
|-
| [[Repository plugins]]
| repository
| /repository
| Connect to external sources of files to use in Moodle
| 2.0+
|-
| [[SCORM reports]]
| scormreport
| /mod/scorm/report
| Analysis of SCORM attempts
| 2.2+
|-
| [[Themes]]
| theme
| /theme
| Change the look of Moodle by changing the the HTML and the CSS.
| 2.0+
|-
| [[TinyMCE editor add-on]]
| tinymce
| /lib/editor/tinymce/plugins
| Extra functionality for the TinyMCE text editor.
| ???
|-
| [[User profile fields]]
| profilefield
| /user/profile/field
| Add new types of data to user profiles
| 1.9+
|-
| [[Webservice protocols]]
| webservice
| /webservice
| Define new protocols for web service communication (such as SOAP, XML-RPC, JSON, REST ...)
| 2.0+
|-
| [[Workshop allocation methods]]
| workshopallocation
| /mod/workshop/allocation
| Define ways how submissions are assigned for assessment in the [[Workshop]] module
| 2.0+
|-
| [[Workshop evaluation methods]]
| workshopeval
| /mod/workshop/eval
| Implement the calculation of the grade for assessment (grading grade) in the [[Workshop]] module
| 2.0+
|-
| [[Workshop grading strategies]]
| workshopform
| /mod/workshop/form
| Define the type of the grading form and implement the calculation of the grade for submission in the [[Workshop]] module
| 2.0+
|}

PRO TIP: You can get the most exact list of types in your version of Moodle with the following script:
<code php>
<?php
define('CLI_SCRIPT', true);
require('path/to/config.php'); // global moodle config file.
print_object(get_plugin_types());
</code>

==Things you can find in all plugins==

Although there are many different types of plugin, there are some things that work the same way in all plugin types, and we have [[Things that work the same in all plugin types|a page that describes them]].

== Naming conventions ==

Warning, if you have to choose a plugin (directory) name. The name is validated by the method <tt>lib/classes/component.php::is_valid_plugin_name()</tt> with a regexp :
<tt>/^[a-z](?:[a-z0-9_](?!__))*[a-z0-9]+$/</tt>
In particular, the minus (-) character is not considered as valid, and the plugin will be silently ignored if the name is not valid.

==See also==
* [[Guidelines_for_contributed_code|Guidelines for contributing code]]
* [[Core APIs]]
* [[Frankenstyle]]
* [http://moodle.org/plugins Moodle Plugins directory]

[[Category:Coding guidelines|Plugins]]
[[Category:Plugins]]

External tool source

2015-08-25T18:44:15Z

Psychoph: Created page with "== LTI Source Plugins == The External tool supports sub plugins that live under the ''mod/lti/source'' directory with the plugin type of ''ltisource''. The purpose of a LTI..."

== LTI Source Plugins ==

The External tool supports sub plugins that live under the ''mod/lti/source'' directory with the plugin type of ''ltisource''. The purpose of a LTI source plugin is to extend the functionality of the External Tool activity.

The LTI source plugins support the following standard plugin features:

* Language file: ''mod/lti/source/pluginname/lang/en/ltisource_pluginname.php''
* [[Upgrade_API| Plugin upgrade API]] under the ''mod/lti/source/pluginname/db'' directory.

=== Extending the LTI protocol ===

The most powerful extension that the LTI source plugins can perform is to extend the LTI services provided by the External Tool activity. All incoming requests are handled by ''mod/lti/service.php'' and all standard LTI requests are automatically handled. But, if the request is non-standard, then a LTI source plugin can have an opportunity to handle the request.

The request is routed to the LTI source plugin by using the message type. For example, let's say this request was sent to the External Tool:

<code xml>
<?xml version="1.0" encoding="UTF-8"?>
<imsx_POXEnvelopeRequest xmlns="http://www.imsglobal.org/services/ltiv1p1/xsd/imsoms_v1p0">
<imsx_POXHeader>
<imsx_POXRequestHeaderInfo>
<imsx_version>V1.0</imsx_version>
<imsx_messageIdentifier>999998123</imsx_messageIdentifier>
</imsx_POXRequestHeaderInfo>
</imsx_POXHeader>
<imsx_POXBody>
<myCustomRequest>
<myRecord>
<sourcedGUID>
<sourcedId>3124567</sourcedId>
</sourcedGUID>

</myRecord>
</myCustomRequest>
</imsx_POXBody>
</imsx_POXEnvelopeRequest>
</code>

In the above request, the message type is '''myCustomRequest'''. Since this is not a standard request, a LTI source plugin can handle it. We can do this by adding a LTI source plugin and for this example, we will call it ''widget''. Then, in our ''ltisource_widget'' plugin, we must define a specific function In order to handle the request. The function name takes on the form of '''component'''_'''messageType'''. So, for our above request example we would create ''mod/lti/source/widget/lib.php'' and add this function to the file:

<code php>
/**
* Handle a custom widget request.
*
* @param object $data The LTI request details
*/
function ltisource_widget_myCustomRequest($data) {
$data->body; // The raw LTI request XML body.
$data->xml; // A SimpleXMLElement of the XML body.
$data->messageid; // The value of the <imsx_messageIdentifier> element in the request.
$data->messagetype; // The message type.
$data->consumerkey; // OAuth consumer key.
$data->sharedsecret; // The shared secret used to verify the request body.

// Do your custom work here.

// Throw exceptions on error, they will be sent back appropriately.

// When done, echo out your response XML.
$responsexml = lti_get_response_xml(
'success',
'Widget handled',
$data->messageid,
$data->messagetype
);

echo $responsexml->asXML();
}
</code>

'''Word of warning:''' If more than one LTI source plugins implement a function for handling the ''myCustomRequest'' message, then an exception will be thrown. So, when coming up with names for your message types, try to keep them unique and perhaps prefix them with something unique about your service.

And that's about it! With this extension point, you can build deep integrations with external services all while communicating through the LTI protocol.

=== Addition to the add activities menu ===

Overall, the following has a narrow use case, but it might be expanded in the future.

A LTI source plugin can add itself to the add activities menu by implementing a '''component'''_get_types function in its lib.php file. So, for example, if our LTI source plugin was ''widget'', then in ''mod/lti/source/widget/lib.php'' we would add the following function:

<code php>
function ltisource_widget_get_types() {
$types = array();
$types[] = (object) array(
'modclass' => MOD_CLASS_ACTIVITY,
'type' => 'lti&type=widget',
'typestr' => get_string('addwidget', 'ltisource_widget'),
'help' => get_string('addwidget_help', 'ltisource_widget'),
);
return $types;
}
</code>

But, this on its own doesn't actually do much at the moment. You must also add another callback that gets called from the External Tool add instance form. The callback takes on the form of '''component'''_add_instance_hook. So, also add this function to ''mod/lti/source/widget/lib.php'':

<code php>
function ltisource_widget_add_instance_hook() {
// Do custom work here.
}
</code>

At this point, the most common use case is to redirect to an external site to browse ''widget-like'' content. Then the '''Extending the LTI protocol''' section can be used to create ''widget-like'' content in Moodle.

Plugin types

2015-08-25T18:42:34Z

Psychoph:

{{Plugins development}}

The M in Moodle stands for modular. The easiest and most maintainable way to add new functionality to Moodle is by writing one of these types of plugin.
If none of the standardized types fits your needs, you can use the "local" type.

{| class="nicetable"
|-
! Plugin type
! Component name
! Moodle path
! Description
! Moodle versions
|-
| [[Activity modules]]
| mod
| /mod
| Activity modules are the most important type of plugins. They provide activities in courses. For example: Forum, Quiz and Assignment.
| All
|-
| [[Admin reports]]
| report
| /admin/report
| Provides useful views of data in a Moodle site, for admins only.
| Up to 2.1 (for 2.2+ see [[Reports]])
|-
| [[Admin tools]]
| tool
| /admin/tool
| Provides utility scripts useful for admins to examine and modify a Moodle site
| 2.2+
|-
| [[Assignment types|Assignment 2.2 types]]
| assignment
| /mod/assignment/type
| Different forms of assignments to be graded by teachers
| 1.x - 2.2
|-
| [[Assign_submission_plugins|Assignment 2.3 submissions]]
| assignsubmission
| /mod/assign/submission
| Different forms of assignment submissions
| 2.3+
|-
| [[Assign_feedback_plugins|Assignment 2.3 feedbacks]]
| assignfeedback
| /mod/assign/feedback
| Different forms of assignment feedbacks
| 2.3+
|-
| [[Atto|Atto editor plugin]]
| atto
| /lib/editor/atto/plugins
| Extra functionality for the Atto text editor
| 2.7+
|-
| [[Authentication plugins]]
| auth
| /auth
| Allows connection to external sources of authentication
| 2.0+
|-
| [[Availability conditions]]
| availability
| /availability/condition
| Conditions to restrict user access to activities and sections.
| 2.7+ (proposed)
|-
| [[Book tool]]
| booktool
| /mod/book/tool
| Small information-displays or tools that can be moved around pages
| ???
|-
| [[Blocks]]
| block
| /blocks
| Small information-displays or tools that can be moved around pages
| 2.0+
|-
| [[Cache store]]
| cachestore
| /cache/stores
| Cache storage back-ends.
| 2.4+
|-
| [[Cache locks]]
| cachelock
| /cache/locks
| Cache lock implementations.
| 2.4+
|-
| [[Calendar types]]
| calendartype
| /calendar/type
| Defines how dates are displayed throughout Moodle
| 2.6+
|-
| [[Course formats]]
| format
| /course/format
| Different ways of laying out the activities and blocks in a course
| 1.3+
|-
| [[Course reports]]
| coursereport
| /course/report
| Reports of activity within the course
| Up to 2.1 (for 2.2+ see [[Reports]])
|-
| [[Database fields]]
| datafield
| /mod/data/field
| Different types of data that may be added to the Database activity module
| 1.6+
|-
| [[Database presets]]
| datapreset
| /mod/data/preset
| Pre-defined templates for the Database activity module
| 1.6+
|-
| [[Editors]]
| editor
| /lib/editor
| Alternative text editors for editing content
| 2.0+
|-
| [[Enrolment plugins]]
| enrol
| /enrol
| Ways to control who is enrolled in courses
| 2.0+
|-
| [[External tool source]]
| ltisource
| /mod/lti/source
| LTI providers can be added to external tools easily through the external tools interface see [[External_tool]]. This type of plugin is specific to LTI providers that need a plugin that can register custom handlers to process LTI messages
| 2.7+
|-
| [[Filters]]
| filter
| /filter
| Automatically convert, highlight, and transmogrify text posted into Moodle.
| 1.4+
|-
| [[Gradebook export]]
| gradeexport
| /grade/export
| Export grades in various formats
| 1.9+
|-
| [[Gradebook import]]
| gradeimport
| /grade/import
| Import grades in various formats
| 1.9+
|-
| [[Gradebook reports]]
| gradereport
| /grade/report
| Display/edit grades in various layouts and reports
| 1.9+
|-
| [[Grading methods]]
| gradingform
| /grade/grading/form
| Interfaces for actually performing grading in activity modules (eg Rubrics).
| 2.2+
|-
| [[Local plugins]]
| local
| /local
| Generic plugins for local customisations
| 2.0+
|-
| [[Messaging consumers]]
| message
| /message/output
| Send messages to users via different methods (email, sms, jabber, etc)
| 2.0+
|-
| [[Plagiarism plugins]]
| plagiarism
| /plagiarism
| Define external services to process submitted files and content
| 2.0+
|-
| [[Portfolio plugins]]
| portfolio
| /portfolio
| Connect external portfolio services as destinations for users to store Moodle content
| 1.9+
|-
| [[Question behaviours]]
| qbehaviour
| /question/behaviour
| Control how student interact with questions during an attempt
| 2.1+
|-
| [[Question formats]]
| qformat
| /question/format
| Import and export question definitions to/from the question bank
| 1.6+
|-
| [[Question types]]
| qtype
| /question/type
| Different types of question (e.g. multiple-choice, drag-and-drop) that can be used in quizzes and other activities
| 1.6+
|-
| [[Quiz access rules]]
| quizaccess
| /mod/quiz/accessrule
| Add conditions to when or where quizzes can be attempted, for example only from some IP addresses, or student must enter a password first
| 2.2+
|-
| [[Quiz reports]]
| quiz
| /mod/quiz/report
| Display and analyse the results of quizzes, or just plug miscellaneous behaviour into the quiz module
| 1.1+
|-
| [[Reports]]
| report
| /report
| Provides useful views of data in a Moodle site for admins and teachers
| 2.2+
|-
| [[Repository plugins]]
| repository
| /repository
| Connect to external sources of files to use in Moodle
| 2.0+
|-
| [[SCORM reports]]
| scormreport
| /mod/scorm/report
| Analysis of SCORM attempts
| 2.2+
|-
| [[Themes]]
| theme
| /theme
| Change the look of Moodle by changing the the HTML and the CSS.
| 2.0+
|-
| [[TinyMCE editor add-on]]
| tinymce
| /lib/editor/tinymce/plugins
| Extra functionality for the TinyMCE text editor.
| ???
|-
| [[User profile fields]]
| profilefield
| /user/profile/field
| Add new types of data to user profiles
| 1.9+
|-
| [[Webservice protocols]]
| webservice
| /webservice
| Define new protocols for web service communication (such as SOAP, XML-RPC, JSON, REST ...)
| 2.0+
|-
| [[Workshop allocation methods]]
| workshopallocation
| /mod/workshop/allocation
| Define ways how submissions are assigned for assessment in the [[Workshop]] module
| 2.0+
|-
| [[Workshop evaluation methods]]
| workshopeval
| /mod/workshop/eval
| Implement the calculation of the grade for assessment (grading grade) in the [[Workshop]] module
| 2.0+
|-
| [[Workshop grading strategies]]
| workshopform
| /mod/workshop/form
| Define the type of the grading form and implement the calculation of the grade for submission in the [[Workshop]] module
| 2.0+
|}

PRO TIP: You can get the most exact list of types in your version of Moodle with the following script:
<code php>
<?php
define('CLI_SCRIPT', true);
require('path/to/config.php'); // global moodle config file.
print_object(get_plugin_types());
</code>

==Things you can find in all plugins==

Although there are many different types of plugin, there are some things that work the same way in all plugin types, and we have [[Things that work the same in all plugin types|a page that describes them]].

== Naming conventions ==

Warning, if you have to choose a plugin (directory) name. The name is validated by the method <tt>lib/classes/component.php::is_valid_plugin_name()</tt> with a regexp :
<tt>/^[a-z](?:[a-z0-9_](?!__))*[a-z0-9]+$/</tt>
In particular, the minus (-) character is not considered as valid, and the plugin will be silently ignored if the name is not valid.

==See also==
* [[Guidelines_for_contributed_code|Guidelines for contributing code]]
* [[Core APIs]]
* [[Frankenstyle]]
* [http://moodle.org/plugins Moodle Plugins directory]

[[Category:Coding guidelines|Plugins]]
[[Category:Plugins]]

Accessibility

2015-05-26T22:51:59Z

Psychoph:

Websites built with '''accessibility''' in mind are flexible in meeting different user needs, preferences and situations. Though these methods can increase [[Usability|usability]] for everyone who uses the Web they are often legally required to be implemented in a specific effort to prevent discrimination against people with disabilities.

== Starting points ==

These are some readable introductions to accessibility that cover; what accessibility is, why it is important, as well as practical advice.
* [http://www.w3.org/WAI/intro/accessibility.php Web Accessibility Initiative's ''Introduction to Web Accessibility'']
* [http://diveintoaccessibility.info/ Mark Pilgrim's ''Dive into Accessibility'']
* [http://joeclark.org/book/ Joe Clark's ''Building Accessible Websites'' book]

== Moodle Collaborative Accessibility Group ==
To improve the accessibility/usability of this learning management system, we have established this collaboration group to work together with Moodle developers, administrators, IT professionals, and other interested entities and individuals. We welcome anyone who is interested in improving the accessibility of Moodle to join this group. You don’t need to be a technical guru or accessibility expert to join; however, it is expected that you are familiar with the basics of accessibility and are willing to dedicate a few hours each month to this collaboration effort.

Visit http://collaborate.athenpro.org/group/moodle to join the mailing list.

We meet in regional groups once a month to discuss accessibility priorities for each region. Regions meet at the following times:

* North America: We meet on the 3rd Monday of each month at 12pm USA Pacific Daylight Saving Time/7pm UTC. (Time zone converter: http://www.worldtimebuddy.com/)
* Europe: Looking for leadership and members
* Asia Pacific: Looking for leadership and members
* Latin America: Looking for leadership and members

To review past regional meetings or to see up coming meetings visit http://collaborate.athenpro.org/group/moodle/teleconferences/

== Moodle-related accessibility coding guidelines ==

; Use CSS, but still use headings, strong and emphasis
: It is generally a good idea to separate a document's content HTML from how it is presented using CSS. There are some tags that affect a document's presentation but also contribute to the structure and meaning of the content. These tags should remain in HTML. This includes heading tags <code><h1>, <h2>, <h3>...</code>, which are used to form the document's hierarchical structure, and <code></code> and <code></code> tags, which are used to add meaning to sections of text.
; Avoid using background images for important information
: Users of non-visual browsers cannot see images. They can read the <code>alt</code> tags of normal images, but background images are not presented like normal images.
; Image <code>alt</code> and <code>title</code> attributes
* An <code>alt</code> attribute is required (even if empty) on all images.
* If a link is wrapping an <code><img></code>, the <code><img></code> does not need a <code>title</code> attribute if the link has one.
* The <code>alt</code> for an image and the <code>title</code> for its surrounding link should usually differ. An image <code>alt</code> attribute provides a text equivalent to an image, whereas a <code>title</code> attribute adds supplementary information about the purpose or action associated with an image link. Simply repeating the same text in <code>alt</code> and <code>title</code> attributes adds little and can be annoying for screen reader users.
; Links and buttons should be selectable and easily click-able
* An image used as an icon for a user to click should be large enough so that the user can click on it easily.
* Users should be able to navigate to all links and buttons using the keyboard.
* Generally we should avoid having two buttons/links that achieve the same action in the same area. This can be annoying and confusing for users of screen readers.
; Support dynamic interaction with [[ARIA]] attributes
: Events triggered by AJAX and JavaScript can be less obvious to users of non-visual browsers. [[ARIA]] attributes can assist users of such browsers to follow a dynamic change.
; Use labels with inputs
: Context can easily be lost without a visual presentation. Labels are needed on all input input elements (except button) to describe their purpose in a form. Labels should be unique on a page. Repeated elements should have a unique label that identifies the element within its context.
; Use appropriate page titles
: A page title is a starting point for a screen reader. Page titles should be unique and should make sense for the page. Avoid generic page titles.
; All pages should be navigable using just a keyboard
: It should be possible navigate to all points on a page just using a keyboard. Important events triggered by a mouse event should be able to be triggered when the item receives focus through keyboard navigation.
; Avoid using colour alone to express meaning
: Colour-blind users need additional information to gain meaning if colour is used as the emphasising feature. Also keep in mind that colours can have differing significance in different cultures, so colours should be configurable either through settings or language files.
; Role for button-type links
: If a link acts as a button (not forwarding to another page, which is often the case when combined with Javascript), it should declare the ''role'' attribute ''button''. Also, as a button is usually triggered by the Space bar, the Javascript should add proper event listeners on the link to accept this key. Read more at [https://developer.mozilla.org/en-US/docs/Accessibility/ARIA/ARIA_Techniques/Using_the_button_role Mozilla Developer Network]

== Web standards, guidelines and legislation ==

=== International ===

* [http://www.w3.org/WAI/ Web Accessibility Initiative]
** [http://www.w3.org/WAI/intro/wcag.php Web Content Accessibility Guidelines (WCAG)]
** [http://www.w3.org/WAI/intro/wcag20 Web Content Accessibility Guidelines 2.0 (draft)]
*** An article on the [http://www.alistapart.com/articles/tohellwithwcag2 problems with WCAG2] from A List Apart
** [http://www.w3.org/TR/WCAG20-TECHS/client-side-script.html Client-side scripting guidelines]

* [http://www.w3.org/WAI/intro/aria.php W3C ARIA]

* [http://webaim.org/techniques/forms/controls WebAIM Form Accessibility guidelines]
* [http://webaim.org/techniques/aria/ WebAIM ARIA guidelines]

=== USA ===
* [http://www.section508.gov/ Section 508]

=== UK ===
* [http://www.legislation.gov.uk/ukpga/2010/15/contents Equality Act 2010], in particular:
** [http://www.legislation.gov.uk/ukpga/2010/15/section/20 Section 20 - Duty to make adjustments]
** [http://www.legislation.gov.uk/ukpga/2010/15/section/29 Section 29 - Provision of services, etc.]
** [http://www.legislation.gov.uk/ukpga/2010/15/schedule/25 Schedule 25 - Information society services].
: See also the [http://www.equalityhumanrights.com/uploaded_files/EqualityAct/servicescode.pdf Equality Act 2010 Statutory Code of Practice] (PDF) for Services, public functions and associations.
* [http://www.equalityhumanrights.com/advice-and-guidance/public-sector-equality-duty/ Public sector equality duty] created by the Equality Act 2010.
* [http://www.parliament.the-stationery-office.co.uk/pa/ld200001/ldbills/003/2001003.htm SENDA - Special Educational Needs and Disability Act/Bill]
* [http://www.opsi.gov.uk/acts/acts1995/1995050.htm Disability Discrimination Act 1995] (now merged ino the Equality Act 2010).
* [http://www.southampton.ac.uk/web4all/standards/BS_16steps/ BS 8878:2010 – 16 Steps for an accessible web product]

=== Germany ===
* [http://www.einfach-fuer-alle.de/artikel/bitv/ Barrierefreie Informationstechnik-Verordnung - BITV]
===European Union===
* [https://ec.europa.eu/digital-agenda/en/news/proposal-directive-european-parliament-and-council-accessibility-public-sector-bodies-websites Proposal for a Directive of the European Parliament and of the Council] on the accessibility of public sector bodies' websites.

== Tools ==

=== Firefox extensions ===
* [http://firefox.cita.uiuc.edu/ Firefox Accessibility Extension] by the Illinois Center for Information Technology and Web Accessibility (iCITA)
* [[Web developer extension]] for [[Firefox]]
* [[Blank_Your_Monitor_and_Easy_Reading_extension_for_Firefox|Blank Your Monitor and Easy Reading Extension]] for Firefox
* [http://www.deque.com/products/worldspace-fireeyes/download-worldspace-fireeyes|FireEye plugin for Firebug]
* [https://addons.mozilla.org/en-us/firefox/addon/wcag-contrast-checker|Color contrast plugin for Firefox]

=== Chrome extension ===
* [https://chrome.google.com/webstore/detail/color-contrast-analyzer/dagdlcijhfbmgkjokkjicnnfimlebcll Color Contrast Analyzer]
* [https://chrome.google.com/webstore/detail/high-contrast/djcfdncoelnlbldjfhinnjlhdjlikmph High contrast]

=== Accessibility validation tools ===
* [https://chrome.google.com/webstore/detail/accessibility-developer-t/fpkknkljclfencbdbgkenhalefipecmb?hl=en Chrome Accessibility Developer Tooks]
* [[W3C validation]] (for [[HTML in Moodle]], [[CSS]] and [[RSS]])
* [http://wave.webaim.org/ Web accessibility evaluation tool]
* [http://cynthiasays.com/ Cynthia Says accessibility checker]

=== Screen readers ===
* [http://www.standards-schmandards.com/projects/fangs/ Fangs – the screen reader emulator] for Firefox
* [http://www.nvda-project.org/ NVDA NonVisual Desktop Access] - open source screen reader for Windows
* [http://webaim.org/projects/screenreadersurvey4// WebAIM Screen reader survey] (Predominance of tools, browsers, OSs used by accessibility users)

See also this [http://www.w3.org/WAI/ER/tools/complete long list of accessibility tools].

See a [http://www.youtube.com/playlist?list=PLmQqs2jGU8Pr7e-3Fz2PoN6AabEkEBRYX live demonstration of a number of accessibility tools].

== Resources ==

* [http://webstandards.org/action/atf/manifesto/ Web Standards.org's ''Accessibility Task Force Manifesto'']
* [http://alistapart.com/topics/userscience/accessibility/ Accessibility articles from ''A List Apart'']
* [http://diveintomark.org/archives/2003/08/29/semantics Mark Pilgrim's ''Won’t somebody please think of the gerbils?'']
: [http://diveintoaccessibility.org/ Dive Into Accessibility] by Mark Pilgrim
* [http://joeclark.org/access/webaccess/ Joe Clark's writings on accessibility]
: [http://joeclark.org/book/ Building Accessible Websites] by Joe Clark (online version)
* [http://en.wikipedia.org/wiki/Web_accessibility Wikipedia article on ''Web Accessibility'']
* [http://juicystudio.com/article/validity-accessibility.php ''Validity and Accessibility'']
* [http://www.edtec.unsw.edu.au/inter/support/accessibility/access_vids.cfm Videos showing as student accessing another Learning Management System via Screen Reader software]

== See also ==

* [[:en:Accessibility|Accessibility statement]] - in current Moodle versions
* [[Semantic HTML]]
* Using Moodle [http://moodle.org/mod/forum/discuss.php?d=85119 New Accessibility Themes] forum discussion
* See [[:en:Usability FAQ]] for the related concept of usability.
* [[:en:Moodle Accessibility Specification]]
* http://moodle.org/mod/forum/discuss.php?d=127807#p559951
* The [http://dev.moodle.org/course/view.php?id=2 Introduction to Moodle Programming] provides some extensive information and discussion on accessibility.
* [http://www.easy.pro.br/ EASY: Interface Between The Virtual Environment Moodle Learning and People with Visual Impairments]
* [http://www.bbc.co.uk/blogs/bbcinternet/2008/03/homepage_accessibilty.html BBC blog post on how their Web 2.0 homepage was made accessible]
* [http://www.bbc.co.uk/accessibility/ BBC Accessibility Help]
* [http://tracker.moodle.org/browse/MDL-7396 Accessibility Compliance in Moodle 1.8]
* [http://tracker.moodle.org/browse/MDL-7860 Compliance with Italian Legislation on Accessibility]

[[Category:Coding guidelines|Accessibility]]
[[Category:Accessibility]]

[[es:Accesibilidad]]
[[fr:Accessibilité]]

Accessibility

2015-05-26T22:51:01Z

Psychoph:

Websites built with '''accessibility''' in mind are flexible in meeting different user needs, preferences and situations. Though these methods can increase [[Usability|usability]] for everyone who uses the Web they are often legally required to be implemented in a specific effort to prevent discrimination against people with disabilities.

== Starting points ==

These are some readable introductions to accessibility that cover; what accessibility is, why it is important, as well as practical advice.
* [http://www.w3.org/WAI/intro/accessibility.php Web Accessibility Initiative's ''Introduction to Web Accessibility'']
* [http://diveintoaccessibility.info/ Mark Pilgrim's ''Dive into Accessibility'']
* [http://joeclark.org/book/ Joe Clark's ''Building Accessible Websites'' book]

== Moodle Collaborative Accessibility Group ==
To improve the accessibility/usability of this learning management system, we have established this collaboration group to work together with Moodle developers, administrators, IT professionals, and other interested entities and individuals. We welcome anyone who is interested in improving the accessibility of Moodle to join this group. You don’t need to be a technical guru or accessibility expert to join; however, it is expected that you are familiar with the basics of accessibility and are willing to dedicate a few hours each month to this collaboration effort.

Visit [http://collaborate.athenpro.org/group/moodle] to join the mailing list.

We meet in regional groups once a month to discuss accessibility priorities for each region. Regions meet at the following times:

* North America: We meet on the 3rd Monday of each month at 12pm USA Pacific Daylight Saving Time/7pm UTC. (Time zone converter: http://www.worldtimebuddy.com/)
* Europe: Looking for leadership and members
* Asia Pacific: Looking for leadership and members
* Latin America: Looking for leadership and members

To review past regional meetings or to see up coming meetings visit [http://collaborate.athenpro.org/group/moodle/teleconferences/]

== Moodle-related accessibility coding guidelines ==

; Use CSS, but still use headings, strong and emphasis
: It is generally a good idea to separate a document's content HTML from how it is presented using CSS. There are some tags that affect a document's presentation but also contribute to the structure and meaning of the content. These tags should remain in HTML. This includes heading tags <code><h1>, <h2>, <h3>...</code>, which are used to form the document's hierarchical structure, and <code></code> and <code></code> tags, which are used to add meaning to sections of text.
; Avoid using background images for important information
: Users of non-visual browsers cannot see images. They can read the <code>alt</code> tags of normal images, but background images are not presented like normal images.
; Image <code>alt</code> and <code>title</code> attributes
* An <code>alt</code> attribute is required (even if empty) on all images.
* If a link is wrapping an <code><img></code>, the <code><img></code> does not need a <code>title</code> attribute if the link has one.
* The <code>alt</code> for an image and the <code>title</code> for its surrounding link should usually differ. An image <code>alt</code> attribute provides a text equivalent to an image, whereas a <code>title</code> attribute adds supplementary information about the purpose or action associated with an image link. Simply repeating the same text in <code>alt</code> and <code>title</code> attributes adds little and can be annoying for screen reader users.
; Links and buttons should be selectable and easily click-able
* An image used as an icon for a user to click should be large enough so that the user can click on it easily.
* Users should be able to navigate to all links and buttons using the keyboard.
* Generally we should avoid having two buttons/links that achieve the same action in the same area. This can be annoying and confusing for users of screen readers.
; Support dynamic interaction with [[ARIA]] attributes
: Events triggered by AJAX and JavaScript can be less obvious to users of non-visual browsers. [[ARIA]] attributes can assist users of such browsers to follow a dynamic change.
; Use labels with inputs
: Context can easily be lost without a visual presentation. Labels are needed on all input input elements (except button) to describe their purpose in a form. Labels should be unique on a page. Repeated elements should have a unique label that identifies the element within its context.
; Use appropriate page titles
: A page title is a starting point for a screen reader. Page titles should be unique and should make sense for the page. Avoid generic page titles.
; All pages should be navigable using just a keyboard
: It should be possible navigate to all points on a page just using a keyboard. Important events triggered by a mouse event should be able to be triggered when the item receives focus through keyboard navigation.
; Avoid using colour alone to express meaning
: Colour-blind users need additional information to gain meaning if colour is used as the emphasising feature. Also keep in mind that colours can have differing significance in different cultures, so colours should be configurable either through settings or language files.
; Role for button-type links
: If a link acts as a button (not forwarding to another page, which is often the case when combined with Javascript), it should declare the ''role'' attribute ''button''. Also, as a button is usually triggered by the Space bar, the Javascript should add proper event listeners on the link to accept this key. Read more at [https://developer.mozilla.org/en-US/docs/Accessibility/ARIA/ARIA_Techniques/Using_the_button_role Mozilla Developer Network]

== Web standards, guidelines and legislation ==

=== International ===

* [http://www.w3.org/WAI/ Web Accessibility Initiative]
** [http://www.w3.org/WAI/intro/wcag.php Web Content Accessibility Guidelines (WCAG)]
** [http://www.w3.org/WAI/intro/wcag20 Web Content Accessibility Guidelines 2.0 (draft)]
*** An article on the [http://www.alistapart.com/articles/tohellwithwcag2 problems with WCAG2] from A List Apart
** [http://www.w3.org/TR/WCAG20-TECHS/client-side-script.html Client-side scripting guidelines]

* [http://www.w3.org/WAI/intro/aria.php W3C ARIA]

* [http://webaim.org/techniques/forms/controls WebAIM Form Accessibility guidelines]
* [http://webaim.org/techniques/aria/ WebAIM ARIA guidelines]

=== USA ===
* [http://www.section508.gov/ Section 508]

=== UK ===
* [http://www.legislation.gov.uk/ukpga/2010/15/contents Equality Act 2010], in particular:
** [http://www.legislation.gov.uk/ukpga/2010/15/section/20 Section 20 - Duty to make adjustments]
** [http://www.legislation.gov.uk/ukpga/2010/15/section/29 Section 29 - Provision of services, etc.]
** [http://www.legislation.gov.uk/ukpga/2010/15/schedule/25 Schedule 25 - Information society services].
: See also the [http://www.equalityhumanrights.com/uploaded_files/EqualityAct/servicescode.pdf Equality Act 2010 Statutory Code of Practice] (PDF) for Services, public functions and associations.
* [http://www.equalityhumanrights.com/advice-and-guidance/public-sector-equality-duty/ Public sector equality duty] created by the Equality Act 2010.
* [http://www.parliament.the-stationery-office.co.uk/pa/ld200001/ldbills/003/2001003.htm SENDA - Special Educational Needs and Disability Act/Bill]
* [http://www.opsi.gov.uk/acts/acts1995/1995050.htm Disability Discrimination Act 1995] (now merged ino the Equality Act 2010).
* [http://www.southampton.ac.uk/web4all/standards/BS_16steps/ BS 8878:2010 – 16 Steps for an accessible web product]

=== Germany ===
* [http://www.einfach-fuer-alle.de/artikel/bitv/ Barrierefreie Informationstechnik-Verordnung - BITV]
===European Union===
* [https://ec.europa.eu/digital-agenda/en/news/proposal-directive-european-parliament-and-council-accessibility-public-sector-bodies-websites Proposal for a Directive of the European Parliament and of the Council] on the accessibility of public sector bodies' websites.

== Tools ==

=== Firefox extensions ===
* [http://firefox.cita.uiuc.edu/ Firefox Accessibility Extension] by the Illinois Center for Information Technology and Web Accessibility (iCITA)
* [[Web developer extension]] for [[Firefox]]
* [[Blank_Your_Monitor_and_Easy_Reading_extension_for_Firefox|Blank Your Monitor and Easy Reading Extension]] for Firefox
* [http://www.deque.com/products/worldspace-fireeyes/download-worldspace-fireeyes|FireEye plugin for Firebug]
* [https://addons.mozilla.org/en-us/firefox/addon/wcag-contrast-checker|Color contrast plugin for Firefox]

=== Chrome extension ===
* [https://chrome.google.com/webstore/detail/color-contrast-analyzer/dagdlcijhfbmgkjokkjicnnfimlebcll Color Contrast Analyzer]
* [https://chrome.google.com/webstore/detail/high-contrast/djcfdncoelnlbldjfhinnjlhdjlikmph High contrast]

=== Accessibility validation tools ===
* [https://chrome.google.com/webstore/detail/accessibility-developer-t/fpkknkljclfencbdbgkenhalefipecmb?hl=en Chrome Accessibility Developer Tooks]
* [[W3C validation]] (for [[HTML in Moodle]], [[CSS]] and [[RSS]])
* [http://wave.webaim.org/ Web accessibility evaluation tool]
* [http://cynthiasays.com/ Cynthia Says accessibility checker]

=== Screen readers ===
* [http://www.standards-schmandards.com/projects/fangs/ Fangs – the screen reader emulator] for Firefox
* [http://www.nvda-project.org/ NVDA NonVisual Desktop Access] - open source screen reader for Windows
* [http://webaim.org/projects/screenreadersurvey4// WebAIM Screen reader survey] (Predominance of tools, browsers, OSs used by accessibility users)

See also this [http://www.w3.org/WAI/ER/tools/complete long list of accessibility tools].

See a [http://www.youtube.com/playlist?list=PLmQqs2jGU8Pr7e-3Fz2PoN6AabEkEBRYX live demonstration of a number of accessibility tools].

== Resources ==

* [http://webstandards.org/action/atf/manifesto/ Web Standards.org's ''Accessibility Task Force Manifesto'']
* [http://alistapart.com/topics/userscience/accessibility/ Accessibility articles from ''A List Apart'']
* [http://diveintomark.org/archives/2003/08/29/semantics Mark Pilgrim's ''Won’t somebody please think of the gerbils?'']
: [http://diveintoaccessibility.org/ Dive Into Accessibility] by Mark Pilgrim
* [http://joeclark.org/access/webaccess/ Joe Clark's writings on accessibility]
: [http://joeclark.org/book/ Building Accessible Websites] by Joe Clark (online version)
* [http://en.wikipedia.org/wiki/Web_accessibility Wikipedia article on ''Web Accessibility'']
* [http://juicystudio.com/article/validity-accessibility.php ''Validity and Accessibility'']
* [http://www.edtec.unsw.edu.au/inter/support/accessibility/access_vids.cfm Videos showing as student accessing another Learning Management System via Screen Reader software]

== See also ==

* [[:en:Accessibility|Accessibility statement]] - in current Moodle versions
* [[Semantic HTML]]
* Using Moodle [http://moodle.org/mod/forum/discuss.php?d=85119 New Accessibility Themes] forum discussion
* See [[:en:Usability FAQ]] for the related concept of usability.
* [[:en:Moodle Accessibility Specification]]
* http://moodle.org/mod/forum/discuss.php?d=127807#p559951
* The [http://dev.moodle.org/course/view.php?id=2 Introduction to Moodle Programming] provides some extensive information and discussion on accessibility.
* [http://www.easy.pro.br/ EASY: Interface Between The Virtual Environment Moodle Learning and People with Visual Impairments]
* [http://www.bbc.co.uk/blogs/bbcinternet/2008/03/homepage_accessibilty.html BBC blog post on how their Web 2.0 homepage was made accessible]
* [http://www.bbc.co.uk/accessibility/ BBC Accessibility Help]
* [http://tracker.moodle.org/browse/MDL-7396 Accessibility Compliance in Moodle 1.8]
* [http://tracker.moodle.org/browse/MDL-7860 Compliance with Italian Legislation on Accessibility]

[[Category:Coding guidelines|Accessibility]]
[[Category:Accessibility]]

[[es:Accesibilidad]]
[[fr:Accessibilité]]

Advanced Forums Accessible Display Specification

2013-09-12T19:18:35Z

Psychoph: /* Student Views a Private Reply */

=== Visioning ===

==== Overview ====

The Moodle forums is not as accessible as it could be. In order to improve usability of forums for those with disabilities Moodlerooms is will enhance advanced forums to display discussions based on EASI: Equal Access to Software & Information’s accessible forum design.

==== Business Goals ====

# Progress towards NFB Certification
# Keep strategic clients
# Improve sales for prospects with high accessibility requirements.

==== Product Goals ====

# Increase the accessibility of forum discussion display
# Increase usability of forums

==== Business References ====

* University of Montana (UofM)
* National Federation of the Blind (NFB)
* Department of Education
* [[http://easi.cc/|ASI: EQUAL ACCESS TO SOFTWARE & INFORMATION]]
* [[http://webaim.org/|WebAIM]]
* [[http://collaborate.athenpro.org/group/moodle/|Moodle Accessibility Group]]

=== Scenarios ===

==== Administrator Sets Advanced Forums as the Forums for All Forums on a Site ====

The administrator needs to force all forums to be created as advanced forums to meet the institutions accessibility policy. To do this the administrator sets all news forums to be created as advanced forums and disabled each roles capabilities to create forums.

==== Teacher Restricts Number of Replies ====

In order to keep forum conversations on topic the student wants to keep the depth of replies to a minimal. After a number of replies to replies a user will not be able to create a reply to a reply.

==== A Visually Impaired Student Listens to Posts in a Course Forum ====

A student needs to review the new posts that students and students have posted to their course forums. Using a screen reader the student accesses the forum and listens to the replies that have been made in the forum.

==== A Visually Impaired Student Replies to a Post in a Course Forum ====

A student wants to reply to a discussion made by the student. Using a screen reader the student navigates to the discussion and hits return when they find the reply link. The student is then placed in a text editor to create their reply. The student then saves the reply by navigating to the post button.

==== A Visually Impaired Student Sorts Forum Discussions ====

A student wants to sort the discussions by which have the newest posts in order to understand what the latest changes are to the forum. The student navigates to the sort using a screen reader and hits enter when they have found the sort by newest post.

=== References ===

==== Jira ====

==== Technical ====

* [[http://easi.cc/archive/bb2013/recording/index.htm|Recording of a discussion on the accessible prototype (EASI)]]
* [[https://dl.dropboxusercontent.com/u/137779786/discussion_module_mockup/discussion_board-listview.html|Prototype of an accessible forum (ESAI) ]]
* [[http://www.oaa-accessibility.org/examples/|OpenAjax Accessibility examples]]
* [[http://webaim.org/techniques/keyboard/accesskey|WebAIM on keyboard shortcuts]]

=== Feature Information ===

==== Advanced Forums Site Settings ====

===== Description =====

Advanced forums will allow administrators to set the default forum display (renamed from discussion display) for all users. Advanced forums will also allow a site administrator to set the default maximum reply depth.

===== Requirements =====

# Rename Discussion display to Forum display in advanced forums display types.
# A new checkbox administrative settings called Create news forums as advanced forums will be added to the activity’s administrative settings page. See [[#AdvancedForumAdministrativeSettings|Mockup: Advanced Forum Administrative Settings]]
# The default value for the Create news forums as advanced forums is unchecked aka no.
# A new select box administrative settings called Default forum display will be added to the activity’s administrative settings page. See [[#AdvancedForumAdministrativeSettings|Mockup: Advanced Forum Administrative Settings]]
# The default value for the Default forum display is default
# The possible values for the Default forum display will be:
## Accessible
## Default
## Nested
## Tree
# A new administrative settings called Maximum reply depth will be added to the activity’s administrative settings page. See [[#AdvancedForumAdministrativeSettings|Mockup: Advanced Forum Administrative Settings]]
# The maximum reply depth will use a drop-down and have the values 1-10 and then the final value of unlimited.
# The default value for the Maximum reply depth will be 3. See [[#AdvancedForumAdministrativeSettings|Mockup: Advanced Forum Administrative Settings]]

===== Mockups =====

====== Advanced Forum Administrative Settings ======

[[Image:afAdminSettings.png|afAdminSettings.png]]

===== Use Cases =====

====== Administrator Sets Default Forum Display ======

'''Description'''

The administrator sets the default forum display to accessible.

'''Preconditions'''

# The user is logged in
# The user is assigned as a site administrator
# The user is at the site level

'''Steps'''

# The administrator clicks on the ''Plugins'' link group under the Settings block
# The administrator clicks on the ''Activity modules'' link group
# The administrator clicks on the ''Advanced forums'' link
# The administrator selects ''Accessible'' from the ''Default forum display'' select box
# The administrator clicks the ''Save changes'' button

'''Postconditions'''

# the settings are saved

====== Administrator Sets the Site to Create all News Forums as Advanced Forums ======

'''Description'''

The administrator sets the site to use advanced forums for all newly created news forums.

'''Preconditions'''

# The user is logged in
# The user is assigned as a site administrator
# The user is at the site level

'''Steps'''

# The administrator clicks on the ''Plugins'' link group under the Settings block
# The administrator clicks on the ''Activity modules'' link group
# The administrator clicks on the ''Advanced forums'' link
# The administrator clicks the checkbox to the left of Create all new forums as advanced forums
# The administrator clicks the ''Save changes'' button

'''Postconditions'''

# The settings are saved

====== Administrator Sets the Default Maximum Reply Depth ======

'''Description'''

The administrator sets the default maximum reply depth for all newly created forums to be 1.

'''Preconditions'''

# The user is logged in
# The user is assigned as a site administrator
# The user is at the site level

'''Steps'''

# The administrator clicks on the ''Plugins'' link group under the Settings block
# The administrator clicks on the ''Activity modules'' link group
# The administrator clicks on the ''Advanced forums'' link
# The administrator selects 1 in the text box to the right of the Maximum reply depth setting.
# The administrator clicks the ''Save changes'' button

'''Postconditions'''

# The settings are saved.

====== Administrator Creates a Course With an Advanced Forums News Forum ======

'''Description'''

The administrator creates a course with a news forum. The news forum is created as an advanced forum.

'''Preconditions'''

# The user is logged in
# The user is assigned as a site administrator
# The advanced forum setting create news forums as advanced forums is checked.
# The user is at the site level

'''Steps'''

# The administrator clicks the ''Courses'' link group
# The administrator clicks the ''Add/edit courses'' link
# The administrator clicks the ''Add a new course'' button
# The administrator fills out the course information
# The administrator clicks the ''Save changes'' button

'''Postconditions'''

# The news forum created for the course is an advanced forum.

==== Advanced Forum Accessible Settings ====

===== Description =====

A new setting will be added to the create a forum screen that will allow the student to restrict the maximum depth of replies for a discussion.

===== Requirements =====

# A new setting will be added to the create a forum screen under the general group called maximum [[#replydepth|reply depth]]. See [[#AdvancedForumDepthSetting|Mockup: Advanced Forum Depth Setting]]
# The default value for the maximum [[#replydepth|reply depth]] will be 3
# The maximum [[#replydepth|reply depth]] will be unlimited
# Once the [[#replydepth|reply depth]] in a discussion reaches maximum reply depth the a student will not be able to reply to the reply. See [[#MaximumReplyDepthDisplay|Mockup: Maximum Reply Depth Display]]
# When a teacher creates a reply to the maximum depth reply the reply will be marked automatically as a private reply.
# A teacher will be unable to uncheck the private reply checkbox for a reply to a reply at the maximum reply depth. See [[#TeacherReplytoaMaximumDepthReply|Mockup: Teacher Reply to a Maximum Depth Reply]]
# On upgrade all existing advanced forums will have their maximum reply depth set to unlimited.

===== Mockups =====

====== Advanced Forum Depth Setting ======

[[Image:afMaxDepthSetting.png|afMaxDepthSetting.png]]

====== Maximum Reply Depth Display ======

[[Image:afMaxReplyDepthDisplay.png|afMaxReplyDepthDisplay.png]]

====== Teacher Reply to a Maximum Depth Reply ======

[[Image:afMaxReplyPrivateReply.png|afMaxReplyPrivateReply.png]]

===== Use Cases =====

====== Teacher Creates a Forum with a Maximum Reply Depth of 2 ======

'''Description'''

The teacher wants to limit the reply depth to 2 to keep the teachers on track with the forum discussion.

'''Preconditions'''

# The user is logged in
# The users is assigned the teacher role in the course
# The user has navigated to the course
# The course is set to weeks or topics format

'''Steps'''

# The teacher clicks on the add activity link
# The teacher selects Advanced forum
# The teacher fills out the forum information
# The teacher selects 2 from the select box for maximum reply depth

'''Postconditions'''

# Users cannot reply to a reply or a reply
# The teacher can still create a private reply to a reply of a reply

====== A Student Views a Reply at the Maximum Reply Depth ======

'''Description'''

A student views a reply that is at the maximum reply depth.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course with a maximum reply depth
# The forum has multiple replies with one at the maximum reply depth
# The student has navigated to the course

'''Steps'''

# The student clicks on the forum
# The student scrolls to the reply at the maximum reply depth

'''Postconditions'''

# The student doesn’t see the reply link.

====== A Teacher Replies to a Maximum Reply Depth Reply ======

'''Description'''

The student wants to create a private reply to the student’s reply even though it is at the maximum reply depth.

'''Preconditions'''

# The user is logged in
# The user is assigned to the student role in a course
# An advanced forum has been created in the course with a maximum reply depth
# The forum has multiple replies with one at the maximum reply depth
# The student has navigated to the course

'''Steps'''

# The student clicks on the forum
# The student scrolls to the reply at the maximum reply depth
# The student clicks on the reply link
# The student fills out the reply form
# The student clicks the ''Post to forum'' button

'''Postconditions'''

# The Private reply checkbox is checked and disabled
# The student can’t change the reply to a non private reply.

==== Private Reply Display ====

===== Description =====

To improve the accessibility of private replies Moodlerooms will add a string to the front of private replies to identify them to the user.

===== Requirements =====

# Private replies will have the string Private reply: added to the front of the title for the reply. See [[#PrivateReplyDisplay|Mockup: Private Reply Display]]
# The string Private reply will be translatable.

===== Mockups =====

====== Private Reply Display ======

[[Image:afPrivateReply.png|afPrivateReply.png]]

===== Use Cases =====

====== Student Views a Private Reply ======

'''Description'''

A student views a private reply from a student in a forum.

'''Preconditions'''

# The user is logged in
# The user is assigned to the student role in a course
# The student has created a reply in a forum
# A teacher has created a private reply to the student’s reply
# The user has navigated to a course with a private reply in it

'''Steps'''

# The student clicks on the forum
# The student scrolls to view the private reply

'''Postconditions'''

# The string Private reply shows in front of the title for the reply.

==== Accessible Discussion Display ====

===== Description =====

The current display options in advanced forums do not maximize the view for those with disabilities. The accessible discussion display will work to implement the prototype of an accessible forum by ESAI. Users will be able to switch between this discussion display and any other discussion display types.

===== Requirements =====

[test]

# A new discussion display mode will be added to the forum display drop down called accessible.
# The accessible forum display will be separated into 5 areas (See [[#AccessibleDisplayStructure|Mockup: Accessible Display Structure]])
## Moodle breadcrumb at the top
## Filter pane at the top
## Forum description (Only shown if set)
## Forum and Discussion selection pane on the left
## Discussion display pane on the right
# Forum management will still be maintained within Moodle’s navigation and settings blocks and accessed via the themes block display.
# The breadcrumb will initially display the full moodle path to the forum the user selected within the course. See [[#NoDiscussionSelected|Mockup: No Discussion Selected]]
# The user will be able to use skip navigation to jump to the forum/discussion pane. See [[#AccessibleDisplayStructure|Mockup: Accessible Display Structure]]
# Navigation from the Discussion display pane to the Forum and Discussion selection pane
# The access key 1 will be used to move to the focus to the Forum select box
# The access key 2 will be used to move the focus to the discussion selection tree view
# The F6 key will be used to to switch focus to the next pane of the filter, forum and discussion and the discussion display panes. See [[#AccessibleDisplayStructure|Mockup: Accessible Display Structure]]
# The Shift+F6 keys will be used to switch focus to the previous pane of the filter, forum and discussion and the discussion display panes. See [[#AccessibleDisplayStructure|Mockup: Accessible Display Structure]]
# When navigating between panes a screen reader will be informed of the region the user has navigated to.

====== Accessible Display Structure ======

[[Image:afAccessibleDisplayStructure.png|afAccessibleDisplayStructure.png]]

====== No Discussion Selected ======

[[Image:afNoDiscussionSelected.png|afNoDiscussionSelected.png]]

===== Use Cases =====

====== Student Selects Accessible Forum Display ======

'''Description'''

A student will a visual disability wants to maximize their usability of advanced forums and selects the accessible forum display type.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course with a maximum reply depth
# The student has navigated to the course
# The student is using a screen reader

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the screen reader to skip to the main content of the page
# The student tabs to the forum display select drop down
# The student uses the space button to open the the select drop down
# The student uses the arrow keys to highlight the accessible select option
# The student hits the enter key

'''Postconditions'''

# The page reloads
# The accessible forum display appears

====== Student Uses F6 to Navigate Between Panes ======

'''Description'''

A visually impaired user wants to quickly change between the panes in the accessible forum view using the F6 key.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student hits the F6 key

'''Postconditions'''

# The student is taken to the filter pane
# The student is informed they are in the filter region

====== Student Uses Shift+F6 to Navigate Between Panes ======

'''Description'''

A student wants to navigate back through the panes of the accessible forum display using the shift+F6 key combination.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student hits the Shift+F6 key combination

'''Postconditions'''

# The student is taken to the discussion display pane
# The student is informed they are in the discussion display region

====== Student Uses Access key 1 to Navigate to the Forum Selection box ======

'''Description'''

A student wants to jump directory to the forum selector to change the forum they are viewing.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student clicks the screen reader’s key combination for the access 1 key

'''Postconditions'''

# The keyboard focus is set of the forum selector box box

====== Student Uses Access key 2 to Navigate to the Discussion Selection Tree view ======

'''Description'''

A student wants to jump to the discussion tree selector to quickly select a new reply to listen to.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student clicks the screen reader’s key combination for the access 2 key

'''Postconditions'''

# The keyboard focus is set of the discussion selector tree view box

==== Accessible Forum Display Filter Pane ====

===== Description =====

In order to quickly access the information users need from the forums they will need to be able to sort and filter the discussions in the forum. Users will also need to be able to change the forum display to their preferred display from the default or current display.

===== Requirements =====

{note}See original [Specs 2.4 Advanced Forums] for how discussions are sorted using each sort by type{note}

# The filter pane will display the following menus based on the forum configuration for the teacher: (See [[#FilterPaneExpandedTeacher|Mockup: Filter Pane Expanded Teacher]])
## Group menu (only displayed if visible or separate groups is set for the forum)
### All participants
### List of all groups in the grouping assigned to the forum.
## Sort by (each menu item will have a sub menu for changing the sort to ascending or descending)
### Last post date
### Creation date
### Last name
### First name
### Number of replies
## Forum display
### Accessible
### Default
### Nested
### Tree
# The filter pane will display the following menus based on the forum configuration for the student: (See [[#FilterPaneExpandedStudent|Mockup: Filter Pane Expanded Student]])
## Sort by (each menu item will have a sub menu for changing the sort to ascending or descending)
### Last post date
### Creation date
### Last name
### First name
### Number of replies
## Forum display
### Accessible
### Default
### Nested
### Tree
# The filter pane will display the simple forum search form for all users. See [[#FilterPane|Mockup: Filter Pane]]
# The user will be able to tab to the first menu and the search field
# The user will use the left and right arrows to switch between menus and to open sub menus
# The user will use the up and down arrows to navigate between menu items
# The user will use the spacebar to open the menu
# Selecting a sort by option will open up the ascending or descending sub menu. See [[#FilterPaneExpandedStudent|Mockup: Filter Pane Expanded Student]]
# Selecting ascending or descending in a sort by submenu will rest the discussion display pane to its default state. See [[#NoDiscussionSelected|Mockup: No Discussion Selected]]
# Selecting ascending or descending in a sort by submenu will rest the page’s Moodle breadcrumb to the path to the current forum. See [[#NoDiscussionSelected|Mockup: No Discussion Selected]]
# Selecting ascending or descending will sort the discussion list based on the sort by and ascending or descending selection.
# Selecting ascending or descending will set the student’s focus to the Discussion tree view.
# If the forum is not set to use groups in the forum settings then the view group menu in the top navigation will not display. See [[#FilterPaneExpandedStudent|Mockup: Filter Pane Expanded Student]]
# Selecting a group in the view group selector will change the discussion pane to display only discussions for that group and all participants.
# Selecting a group in the view group selector will focus the user on the Discussion tree view
# Selecting a group will reset the discussion view pane to its default state of no discussion or reply being displayed. See [[#NoDiscussionSelected|Mockup: No Discussion Selected]]
# Selecting a group will reset the Moodle breadcrumb to the path to the current forum. See [[#NoDiscussionSelected|Mockup: No Discussion Selected]]
# Selecting a display type in the forum display menu will cause the page to reload and the new forum display to display the forum. See [[#NoDiscussionSelected|Mockup: No Discussion Selected]]
# Clicking the ''Search'' button will bring up the search results in the discussion display pane. See [[#SearchResults|Mockup: Search Results]]
# The search one the filter pane will search only the current forum.
# Clicking the ''Advanced search'' button will display the Advanced search modal. See [[#AdvancedSearchModal|Mockup: Advanced Search Modal]]
# The advanced search modal will lock the user’s keyboard in the modal until the user click the ''Close'', ''Cancel'', or ''Search forums'' button.
# Clicking the ''Search'' button on the filter pane or the ''Search forums'' button in the advanced search modal will display the search results in the discussion display pane. See [[#SearchResults|Mockup: Search Results]]
# The user’s browser focus will be placed on the discussion display pane after a search has finished.
# The search results will display the same as described in the [[#AccessibleForumDiscussionDisplayPane|Section: Accessible Forum Discussion Display Pane]] with a header titled Search results with a count of the number of posts found.
# The action menu for each post in the search results will consist of the following links: (See [[#SearchResults|Mockup: Search Results]])
## Show post in full discussion
## Show post and its replies
# Selecting Show post in full discussion in the action menu will cause the following to happen:
## The discussion display pane will display all posts in the discussion the post is in.
## The user’s browser focus will be placed on the post in the discussion display pane
# Selecting Show post and its replies in the action menu will cause the following to happen:
## The discussion display pane display the post and all replies to the post in the discussion hierarchy.
## The user’s browser focus will be placed on the post in the discussion display pane

===== Mockups =====

====== Filter Pane ======

[[Image:afFilterPane.png|afFilterPane.png]]

====== Filter Pane Expanded Teacher ======

[[Image:afFilterPaneExpandedTeacher.png|afFilterPaneExpandedTeacher.png]]

====== Filter Pane Expanded Student ======

[[Image:afFilterPaneExpandedStudent.png|afFilterPaneExpandedStudent.png]]

====== Search Results ======

[[Image:afSearchResults.png|afSearchResults.png]]

====== Advanced Search Modal ======

[[Image:afAdvancedSearchModal.png|afAdvancedSearchModal.png]]

===== Use Cases =====

====== Student Accesses the Sort by Menu Using a Keyboard ======

'''Description'''

A student accesses the sort by menu drop down using a screen reader and their keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the screen reader to jump to the main content
# The student uses the tab key to tab to the sort by menu

'''Postconditions'''

# Using the tab key the student is able to find the sort by menu
# The student is able to identify using the screen reader which menu they are on.

====== Student Accesses the Search Field Using a Keyboard ======

'''Description'''

A student accesses the search input field using a screen reader and their keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the screen reader to jump to the main content
# The student uses the tab key to tab to the search input field

'''Postconditions'''

# The student is able to identify that entering text in the field will search to forum for posts with that information in it.
# The student is able to identify they are in a form and need to tab to the ''Search forum'' button

====== Student Opens Sort By Menu Using a Keyboard ======

'''Description'''

A student opens the sort by menu using a screen reader and their keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the screen reader to jump to the main content
# The student uses the tab key to tab to the sort by menu
# The student uses the spacebar to open the sort by menu

'''Postconditions'''

# The sort by menu opens for the student
# The screen reader reads all of the sort by menu items.

====== Student Selects Sort By Number of Replies Descending Using a Keyboard ======

'''Description'''

A student selects sort by number or replies in a descending order using a screen reader and their keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display
# The advanced forum has more than 1 discussion and reply

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the screen reader to jump to the main content
# The student uses the tab key to tab to the sort by menu
# The student uses the spacebar to open the sort by menu
# The student uses the down arrow key to locate the ''Number of replies'' menu item
# The student uses the right arrow key to open the ''Number of replies'' sub menu
# The student uses the down arrow key to select the ''Descending'' menu item

'''Postconditions'''

# The discussion list is resorted by number of replies in a descending order
# The student’s browser focus is set to the discussion tree view
# The student is able to understand via the screen reader that they are not accessing the discussion tree view.

====== Student Navigates Between Menus Using a Keyboard ======

'''Description'''

A student accesses each menu using a keyboard and screen reader.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the screen reader to jump to the main content
# The student uses the tab key to tab to the sort by menu
# The student uses the left arrow key to navigate to the forum display menu

'''Postconditions'''

# The student is able to navigate to the forum display using the keyboard

====== Student Selects a Display Type Using a Keyboard ======

'''Description'''

A student changes the display type from accessible to default using a screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the screen reader to jump to the main content
# The student uses the tab key to tab to the sort by menu
# The student uses the left arrow key to navigate to the forum display menu
# The student uses the spacebar to open the forum display menu
# The student uses the down arrow key to select a new forum display type

'''Postconditions'''

# The student is able to navigate to the forum display using the keyboard
# The page is reloaded and the forum is displayed using the new forum display type

====== Teacher Selects a Group Using a Keyboard ======

'''Description'''

A teacher filters the lists of discussions by group using a screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a teacher
# An advanced forum has been created in the course
# The teacher has navigated to the course
# The teacher is using a screen reader
# The teacher has set the accessible forum display
# The advanced forum is setup to have separate groups
# Students are assigned to groups
# The forum has posts to each group as well as all participants.

'''Steps'''

# The teacher uses the screen reader to skip to the main content of the course
# The teacher tabs to the forum activity within the course
# The teacher hits the enter key
# The teacher uses the screen reader to jump to the main content
# The teacher uses the tab key to tab to the sort by menu
# The teacher uses the left arrow key to navigate to the view group menu
# The teacher uses the spacebar to open the view group menu
# The teacher uses the down arrow key to select a group to view

'''Postconditions'''

# The discussion tree view is updated with the discussions available to the selected group and all participants
# The teacher’s browser focus is set to the discussion tree view.

====== Student Searches the Forum Using a Keyboard ======

'''Description'''

A student uses a screen reader and keyboard to access the search input field in the filter pane and search the forum.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display
# There are discussion in the forum
# There are replies in the forum
# There are replies or discussions that match the search criteria in the forum.

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the F6 key to navigate to the filter pane
# The student tabs to the search input field
# The student enters their search text in the search input field
# The student tabs to the search button
# The student hits the enter key to search the forums

'''Postconditions'''

# The posts that are found matching the search criteria display in the discussion display pane
# The user’s browser focus is set to the discussion display pane.

====== Student Uses the Advanced Search to Search the Forum Using a Keyboard ======

'''Description'''

A student search the forum using the advanced search modal, a screen reader and a keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display
# There are discussion in the forum
# There are replies in the forum
# There are replies or discussions that match the search criteria in the forum.

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the F6 key to navigate to the filter pane
# The student tabs to the advanced search button
# The student hits the enter key
# The student uses the tab key to fill out the search criteria
# The student tabs to the search forum button
# The student hits enter to search the forum

'''Postconditions'''

# The posts that are found matching the search criteria display in the discussion display pane
# The user’s browser focus is set to the discussion display pane.

====== Student Displays the Discussion the Search Result is a Part of Using a Keyboard ======

'''Description'''

A student selects the to view the discussion that a search result post is a part of using a screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display
# There are discussion in the forum
# There are replies in the forum
# There are replies or discussions that match the search criteria in the forum.
# The user has finished searching via advanced search or simple search.

'''Steps'''

# The student uses the screen readers next header keyboard commands to locate the reply they want to edit.
# The student hits the tab key to tab to the action menu for the discussion
# The student uses the spacebar to open the action menu
# The student uses the down arrow to select the Show post in full discussion menu item
# The student uses the enter key to select the Show post in full discussion menu item

'''Postconditions'''

# The discussion pane displays the discussion that the post is in
# The user’s bowser focus is set to the post that Show post in full discussion was selected for.

====== Student Displays the Search Result and All Replies Using a Keyboard ======

'''Description'''

A student selects to display the search result post and all of its replies using a screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display
# There are discussion in the forum
# There are replies in the forum
# There are replies or discussions that match the search criteria in the forum.
# The user has finished searching via advanced search or simple search.

'''Steps'''

# The student uses the screen readers next header keyboard commands to locate the reply they want to edit.
# The student hits the tab key to tab to the action menu for the discussion
# The student uses the spacebar to open the action menu
# The student uses the down arrow to select the Show post and its replies menu item
# The student uses the enter key to select the Show post and its replies menu item

'''Postconditions'''

# The discussion pane displays the post and all of its sub replies
# The user’s bowser focus is set to the post that Show post and its replies was selected for.

==== Accessible Forum Display Forum and Discussion Pane ====

===== Description =====

The forum and discussion pane is designed to provide the user with quick access to overall activity within the forum. This is where the user quickly navigates to the discussion or reply they want to view in the discussion pane.

===== Requirements =====

# The Forum and discussion pane will display the following: (See [[#ForumandDiscussionPane|Mockup: Forum and Discussion Pane]])
## A drop down list of all forums in the course with the current forum selected
## A button to ''Add a new discussion topic''
## If visible or separate groups is set for the forum a statement of the setting will display below the forum select box. See [[#ForumandDiscussionPaneSeparateGroups|Mockup: Forum and Discussion Pane Separate Groups]] and [[#ForumandDiscussionPaneVisibleGroups|Mockup: Forum and Discussion Pane Visible Groups]]
## An expandable collapsable list of all discussions and replies in the currently selected forum the user can view.
# The forum selector drop down will not appear if there is only one forum in the course
# The forum selector will list all advanced forums in the course in alphabetical order
# Selecting a forum from the forum drop down will reload the page as if the user had clicked on the forum in the course.
# The ''Add a new discussion topic'' button will not appear for users if they do not have permissions to create a discussion.
# Clicking the ''Add a new discussion topic'' will display the ''Your new discussion topic'' forum in the discussion pane. See [[#NewDiscussionTopic|Mockup: New Discussion Topic]]
# Clicking the ''Post to forum'' button in the ''Your new discussion topic'' form causes the following to happen:
## Save the discussion to the forum
## Add the discussion title in the correct sort order to the discussion tree
## Display the new discussion in the discussion pane
## Place the browser focus on the new discussion.
# Clicking the ''Cancel'' button will cause the following to happen:
## Close the reset the discussion pane to the default state when no discussion is selected
## Return the user’s browser focus to the ''Add a new discussion topic'' button.
# The user will use tab to navigate between the forum selector, add a new discussion topic button and discussion tree.
# A group selector option will display below the mail now form field if a forum is set to separate or visible groups.
# The user will use the up and down arrows to navigate up and down in the discussion tree. See [[#ForumandDiscussionPaneExpanded|Mockup: Forum and Discussion Pane Expanded]]
# The user will use the left and right arrows to expand and contract the discussion tree. See [[#ForumandDiscussionPaneExpanded|Mockup: Forum and Discussion Pane Expanded]]
# The user will be able to use the mouse to click on the + and - images to expand and contract discussions and replies. See [[#ForumandDiscussionPaneExpanded|Mockup: Forum and Discussion Pane Expanded]]
# Discussions that are collapsed and have replies will have a + image to the left of the discussion title and the screen reader will read that the discussion is collapsed. See [[#ForumandDiscussionPaneExpanded|Mockup: Forum and Discussion Pane Expanded]]
# Replies that are collapsed and have replies will have a + image to the left of the reply title and the screen reader will read that the reply is collapsed. See [[#ForumandDiscussionPaneExpanded|Mockup: Forum and Discussion Pane Expanded]]
# Discussions that are expanded and have replies will have a - image to the left of the discussion title and the screen reader will read that the discussion is expanded. See [[#ForumandDiscussionPaneExpanded|Mockup: Forum and Discussion Pane Expanded]]
# Replies that are expanded and have replies will have a - image to the left of the reply title and the screen reader will read that the reply is expanded. See [[#ForumandDiscussionPaneExpanded|Mockup: Forum and Discussion Pane Expanded]]
# When expanded a discussion or reply will display all replies to the discussion in tree form below it. See [[#ForumandDiscussionPaneExpanded|Mockup: Forum and Discussion Pane Expanded]]
# If a discussion or reply has no replies to it then no image will display to the left of the title. See [[#ForumandDiscussionPaneExpanded|Mockup: Forum and Discussion Pane Expanded]]
# Users will use the enter key on a discussion to display the discussion and all replies in the discussion pane. See [[#DiscussionAccessibleDisplay|Mockup: Discussion Accessible Display]]
# Users will click on a discussion to display the discussion and all replies in the discussion pane. See [[#DiscussionAccessibleDisplay|Mockup: Discussion Accessible Display]]
# Users will use the enter key on a reply to display the reply and all replies to the reply in the discussion pane. See [[#SelectedReplyAccessibleDisplay|Mockup: Selected Reply Accessible Display]]
# Users will click on a reply to display the replies and all replies to the reply in the discussion pane. See [[#SelectedReplyAccessibleDisplay|Mockup: Selected Reply Accessible Display]]
# Clicking on a reply or discussion will place the user’s browser focus on the discussion pane
# Hitting the enter key on a discussion or reply link will place the user’s browser focus on the discussion pane.
# The discussion tree will display the number of unread replies for the discussion/reply to the right of the discussion/reply title if the user has read tracking enabled. See [[#ForumandDiscussionPane|Mockup: Forum and Discussion Pane]]
# Forums set to visible or separate groups will add the for and group name to the right of the discussion title when the post is set to a specific group in the discussion tree view. See [[#ForumandDiscussionPaneSeparateGroups|Mockup: Forum and Discussion Pane Separate Groups]] and [[#ForumandDiscussionPaneVisibleGroups|Mockup: Forum and Discussion Pane Visible Groups]]

===== Mockups =====

====== Forum and Discussion Pane ======

[[Image:afForumDiscussionPane.png|afForumDiscussionPane.png]]

====== Forum and Discussion Pane Expanded ======

[[Image:afForumDiscussionPaneExpanded.png|afForumDiscussionPaneExpanded.png]]

====== Forum and Discussion Pane Separate Groups ======

[[Image:afForumDiscussionPaneSeparateGroups.png|afForumDiscussionPaneSeparateGroups.png]]

====== Forum and Discussion Pane Visible Groups ======

[[Image:afForumDiscussionPaneVisibleGroups.png|afForumDiscussionPaneVisibleGroups.png]]

====== Discussion Accessible Display ======

[[Image:afAccessibleDiscussionDisplay.png|afAccessibleDiscussionDisplay.png]]

====== Selected Reply Accessible Display ======

[[Image:afAccessibleReplyDisplay.png|afAccessibleReplyDisplay.png]]

====== New Discussion Topic ======

[[Image:afNewTopicModal.png|afNewTopicModal.png]]

===== Use Cases =====

====== Student Uses a Keyboard to Navigate Between Forum and Discussion Panel Areas ======

'''Description'''

A student navigates between the forum selector, add a new discussion topic and the discussion tree using a screen reader and their keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the F6 key to get to the filter pane
# The student uses the F6 key to get to the forum and discussion pane
# The student uses the tab key to navigate between the areas of the forum and discussion pane

'''Postconditions'''

# The student is able to navigate between the forum selector and discussion tree areas
# The student with the use of the screen reader understands the areas they are navigating between.

====== Student Selects a Different Forum Using a Keyboard ======

'''Description'''

A student navigates to a different forum without going back to the course page using a screen reader and their keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display
# The is more than one forum in the course

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the F6 key to get to the filter pane
# The student uses the F6 key to get to the forum and discussion pane
# The student tabs to the forum selector
# The student uses the spacebar to open the forum selector
# The student uses the down arrow to select the next forum in the course
# The student hits the enter key to select the forum

'''Postconditions'''

# The page is reloaded and the student is in the accessible view of the selected forum.

====== Teacher Adds a New Discussion Topic Using a Keyboard ======

'''Description'''

A teacher with a visual disability adds a new discussion topic to the forum using their screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a teacher
# An advanced forum has been created in the course
# The teacher has navigated to the course
# The teacher is using a screen reader
# The teacher has set the accessible forum display

'''Steps'''

# The teacher uses the screen reader to skip to the main content of the course
# The teacher tabs to the forum activity within the course
# The teacher hits the enter key
# The teacher uses the F6 key to get to the filter pane
# The teacher uses the F6 key to get to the forum and discussion pane
# The teacher uses the tab key to navigate to the ''Add a new discussion topic'' button
# The teacher hit the enter key
# The teacher uses tab to fill in all field in the ''Your new discussion topic'' form
# The teacher tabs to the ''Post to forum'' button
# The teacher hits the enter key

'''Postconditions'''

# The teacher’s post is saved
# The teacher’s browser focus is placed on the discussion pane.
# The discussion tree is updated with the new discussion.

====== Teacher Adds a New Discussion Topic For a Specific Group Using a Keyboard ======

'''Description'''

A teacher with a visual disability adds a new discussion topic to the forum using their screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a teacher
# An advanced forum has been created in the course
# The teacher has navigated to the course
# The teacher is using a screen reader
# The teacher has set the accessible forum display
# The advanced forum is set to separate groups

'''Steps'''

# The teacher uses the screen reader to skip to the main content of the course
# The teacher tabs to the forum activity within the course
# The teacher hits the enter key
# The teacher uses the F6 key to get to the filter pane
# The teacher uses the F6 key to get to the forum and discussion pane
# The teacher uses the tab key to navigate to the ''Add a new discussion topic'' button
# The teacher hit the enter key
# The teacher uses tab to fill in all field in the ''Your new discussion topic'' form
# The teacher selects a specific group from the group selector
# The teacher tabs to the ''Post to forum'' button
# The teacher hits the enter key

'''Postconditions'''

# The teacher’s post is saved
# The teacher’s browser focus is placed back on discussion pane.
# The discussion tree is updated with the new discussion.
# The discussion title has the words for <group name selected> to its right.

====== Student Expands a Discussion Using a Keyboard ======

'''Description'''

A student expands a discussion to listen to all of the replies to the discussion using a screen reader and their keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display
# More than one discussion has been created
# Replies have been posted to discussions

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the F6 key to get to the filter pane
# The student uses the F6 key to get to the forum and discussion pane
# The student uses the tab key to navigate to the discussion tree
# The student uses the left arrow key to expand the replies to the discussion

'''Postconditions'''

# All the titles for the replies of reply depth 1 for the discussion are showing and read to the user via the screen reader

====== Student Expands a Discussion Using a Mouse ======

'''Description'''

A student expands the replies to a discussion using their mouse.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student has set the accessible forum display
# More than one discussion has been created
# Replies have been posted to discussions

'''Steps'''

# The student clicks on the forum in the course
# The student clicks on the plus image to the left of the discussion title

'''Postconditions'''

# All the titles for the replies of reply depth 1 for the discussion are displayed

====== Student Navigated Down the Discussion Tree Using a Keyboard ======

'''Description'''

A student navigates to a reply to a discussion using a screen reader and their keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display
# More than one discussion has been created
# Replies have been posted to discussions

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the F6 key to get to the filter pane
# The student uses the F6 key to get to the forum and discussion pane
# The student uses the tab key to navigate to the discussion tree
# The student uses the down arrow to navigate to the next discussion in the tree

'''Postconditions'''

# The title of the discussion is read to the student via the screen reader

====== Student Selects a Discussion to Display Using a Keyboard ======

'''Description'''

A student selects a discussion using a screen reader and their keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display
# More than one discussion has been created
# Replies have been posted to discussions

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the F6 key to get to the filter pane
# The student uses the F6 key to get to the forum and discussion pane
# The student uses the tab key to navigate to the discussion tree
# The student uses the down arrow to navigate to the next discussion
# The student hits the enter key

'''Postconditions'''

# The student’s browser focus is set to the discussion pane
# The discussion pane is updated to display the full discussion plus all replies in the discussion.

====== Student Selects a Discussion Using a Mouse ======

'''Description'''

A student selects a discussion using their mouse.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student has set the accessible forum display
# More than one discussion has been created
# Replies have been posted to discussions

'''Steps'''

# The student clicks on the forum in the course
# The student clicks on the discussion title

'''Postconditions'''

# The student’s browser focus is set to the discussion pane
# The discussion pane is updated to display the full discussion plus all replies in the discussion.

====== Student Locates a Discussion With Unread Replies using a Keyboard ======

'''Description'''

A student navigates through the discussion tree until they hear a discussion that has new replies to it. The student is using the screen reader and their keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display
# More than one discussion has been created
# Replies have been posted to discussions

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the F6 key to get to the filter pane
# The student uses the F6 key to get to the forum and discussion pane
# The student uses the down arrow to located a discussion with unread replies

'''Postconditions'''

# Each discussion title is read as the user uses the down arrow to navigate down
# The discussion title is read then the number of unread replies.

====== Student Selects a Reply Using a Keyboard ======

'''Description'''

A student navigates to a reply and selects it to listen to in the discussion pane using a screen reader and their keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display
# More than one discussion has been created
# Replies have been posted to discussions

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the F6 key to get to the filter pane
# The student uses the F6 key to get to the forum and discussion pane
# The student uses the right arrow to expand a discussion
# The student hits the enter key

'''Postconditions'''

# The student’s browser focus is set to the discussion pane
# The discussion pane is updated to display the reply and all replies of a reply depth below the starting reply.

====== Student Selects a Reply Using a Mouse ======

'''Description'''

A student navigates to a reply and selects it to listen to in the discussion pane using their mouse.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student has set the accessible forum display
# More than one discussion has been created
# Replies have been posted to discussions

'''Steps'''

# The student clicks on the forum in the course
# The student clicks on the plus image to the left of the discussion title
# The student clicks on the reply title

'''Postconditions'''

# The student’s browser focus is set to the discussion pane
# The discussion pane is updated to display the reply and all replies of a reply depth below the starting reply.

==== Accessible Forum Discussion Display Pane ====

===== Description =====

The discussion display pane is the region of the forum that displays to the user the specific discussion or reply they have chosen with all sub replies. The pane is designed to present the selected discussion or reply in the most accessible manner focusing on simplified content and easy tabbing between actions. HTML headers are used to help inform the user where they are in the hierarchy of the discussion.

{note}It is understood that using HTML header’s to denote the hierarchy of the forum has the issue that HTML only has a header level up to H6. Furthermore H1 is only used once on a page and for the page heading. This is why the maximum reply depth setting has been added. It also should be noted that after a reply depth of 3 forum replies become less focused on the original discussion topic.{note}

===== Requirements =====

# The discussion pane will be separated into 2 areas: (See [[#DiscussionDisplayPaneStructure|Mockup: Discussion Display Pane Structure]])
## Message display area. This is a live area that is updated with message as information is added or removed.
## Discussion/reply display area. This is dynamically updated based on content changes and the forum and discussion pane.
# Messages in the message area will display for 30 seconds and then be removed from the page.
# The message output area will not be accessible by keyboard if there are no messages displayed within the area.
# Each discussion or reply will be separated into 3 areas: (See [[#Discussion/ReplyStructure|Mockup: Discussion/Reply Structure]])
## Heading
## Post
### Post text
### File attachments
## Actions
# A discussion/reply heading will display the following information in this order: (See [[#TeacherViewsOwnDiscussion|Mockup: Teacher Views Own Discussion]])
## Post title using the correct HTML header based on reply depth (see below)
## Author with their image and name, the image will not be identified to a screen reader (alt=“”)
## Post date, the date the post was created
## Rating type and value (this will only display if ratings are enabled for the forum)
# The accessible display mode will use HTML header tags (h2-h6) for the title of the discussion post and replies. See [[#DiscussionAccessibleDisplay|Mockup: Discussion Accessible Display]]
# The discussion post will use a h2 HTML header tag for the title of the post. See [[#DiscussionAccessibleDisplay|Mockup: Discussion Accessible Display]]
# A replies reply depth will determine the HTML header tag to be used for the title: (See [[#DiscussionAccessibleDisplay|Mockup: Discussion Accessible Display]])
## Reply depth 1 will use the HTML header h3
## Reply depth 2 will use the HTML header h4
## Reply depth 3 will use the HTML header h5
## Reply depth 4 will use the HTML header h6
# Forums that allow a reply depth greater then 4 will use the HTML Header tag of H6 for all reply titles at a depth of 4 or greater.
# The post text area will display the post text and then any file attachments in an unordered list below the post text. See [[#Discussion/ReplyStructure|Mockup: Discussion/Reply Structure]]
# If there are no actions the user can perform on the post then the action area and menu will not display
# When the forum is set to separate groups and a discussion is set to all participants the action area and action menu will not display to students.
# Replies in the discussion pane will display based on the reply hierarchy and depth.
# If the teacher is the creator of the discussion or reply their name will be denoted in bold and the screen reader will read “Teacher” before reading the poster’s name.
# Anywhere in the below action menus if the action is subscribe it will be replaced with unsubscribe if the user is already subscribed to the discussion.
# Anywhere in the below action menus if the action bookmark is available the option remove bookmark will show if the discussion or reply is already bookmarked
# Anywhere in the below action menus if the action mark substantive is available the option Unmark substantive will show if the discussion or reply is already marked as substantive.
# Reply will display in the below action menus only if the user has permissions to create a reply
# Rating and view ratings will only display in the action menus if the rating setting is enabled for the forum.
# A teacher will have the following actions available when viewing their own discussion: (See [[#TeacherViewsOwnDiscussion|Mockup: Teacher Views Own Discussion]])
## Edit
## Delete
## View ratings (only displays if ratings are enabled for the forum)
## Subscribe (will not display if subscribed to the forum or forum subscription is disabled)
## Mark substantive
## Bookmark
## Reply
# A teacher will have the following actions available when viewing their own reply: (See [[#TeacherViewsTeacherReply|Mockup: Teacher Views Teacher Reply]])
## Edit
## Split
## Delete
## View ratings (only displays if ratings are enabled for the forum)
## Mark substantive
## Bookmark
## Reply
# A teacher will have the following actions available when viewing a student’s reply: (See [[#TeacherViewsStudentReply|Mockup: Teacher Views Student Reply]])
## Reply
## Split
## Delete
## Rate (only displays if ratings are enabled for the forum)
## Mark substantive
## Bookmark
# A student will have the following actions available when viewing a discussion: (See [[#StudentViewsDiscussion|Mockup: Student Views Discussion]])
## Reply
## Rate
## Subscribe
# A student will have the following actions available when viewing their own reply: (See [[#StudentViewsOwnReply|Mockup: Student Views Own Reply]])
## Edit
## Delete
## Reply
# A private reply will display only to the student who created the original reply and the teachers.
# A teacher will have the following options available when viewing a private reply: (See [[#TeacherViewPrivateReply|Mockup: Teacher View Private Reply]])
## Edit
## Split
## Delete
# The action area and menu will not display to a student for a private reply.
# The user’s picture will display as the default user picture for an anonymous forum. See ([[#AnonymousReply|Mockup: Anonymous Reply]])
# The user’s name will appear as a Anonymous user instead of the creators real name.
# A user will have all the same action menu menu items for an anonymous reply as they would for a reply of the same type in a regular forum.
# A user will be able to use the spacebar to open the action menu
# A user will be able to use the tab key to navigate to a post’s action menu
# A user will be able to use the enter key to select an action menu item.
# Selecting the reply action will bring up the reply form below the post the user is replying to.
# The student reply modal will have the fields in [[#StudentReplyFormInline|Mockup: Student Reply Form Inline]]
# The file upload area will not display if the forum is set to not allow attachments.
# The teacher reply form will have the following additional form fields compared to a student’s reply form based on the type of forum and the forum settings: See ([[#TeacherReplyFormInline|Mockup: Teacher Reply Form Inline]])
## Mail now
## Group (select box with available groups if the forum is set to visible or separate groups)
## Private reply
## Reveal yourself in this post (if the forum is set to anonymous)
# Clicking the ''Post to forum'' button in the reply form will cause the following things to happen:
## The reply is added as the last reply to the post the user selected reply for
## The discussion tree view is updated to reflect the added reply if the parent post is expanded
## The user’s browser focus is placed on the header of the newly created reply.
# Clicking the ''Cancel'' button in the reply form will cause the following things to happen:
## The reply form stops displaying inline below the current post
## The user’s browser focus is placed on the header of the post the user was replying to.
# Selecting the split action will bring up the split post modal. See ([[#SplitPostModal|Mockup: Split Post Modal]])
# The split post modal will key the keyboard locked in the modal until the user clicks the ''Close'', ''Cancel'', or ''Split'' button.
# Clicking the ''Split'' button in the split modal will cause the following things to happen:
## The Split post modal to close
## The post converted to the initial discussion post for the new discussion with the title in the new discussion title field of the modal
## The reply hierarchy for the post are still associated with the post
## The discussion display pane will display the new discussion that the post was split into.
## The user’s browser focus is placed on the header for the initial post of the new discussion
## The discussion tree in the forum and discussion pane is updated to reflect the changes to the forum hierarchy
# Selecting the delete action will bring up a conformation that the user wants to delete the reply or discussion. See ([[#DeleteReplyModal|Mockup: Delete Reply Modal]])
# Clicking the ''Delete post'' button in the delete post modal will do the following things:
## Close the modal
## Remove the post and the reply in the hierarchy attached to the post and lower.
## Add a message to the message output stating “The <post header> was successfully deleted”.
## The user’s browser focus will be placed on the success message.
# The delete post modal will keep the keyboard locked in the modal until the user clicks the ''Close'', ''Cancel'', or ''Delete post'' button.
# Selecting the edit action will bring up the reply form inline pre-populated with the post that is being edited. See ([[#EditReplyForumInline|Mockup: Edit Reply Form Inline]])
# Selecting the rate action will bring up the rate modal pre-populated with the current rating the user has given the post. See [[#RatingModal|Mockup: Rating Modal]]
# The rate post modal will key the keyboard locked in the modal until the user clicks the ''Close'', ''Cancel'', or ''Rate post'' button.
# Clicking the ''Rate'' button in the rate modal will cause the following things to happen:
## The rate post modal will close
## The rating the user had entered will be saved for the post
## The rating for the post will update based on the forum settings.
## A message will be added the message output area stating “The rating was successfully saved” with a link to jump back to the post within the discussion display panel.
# Selecting the view ratings action will bring up the view ratings modal. See ([[#ViewRatingsModal|Mockup: View Ratings Modal]])
# The view ratings modal will keep the user’s keyboard focus until the user clicking on the ''Close'' or ''Close this window'' button.
# Closing a modal using the ''Close'', ''Close this window'' or ''Cancel'' buttons will place the user’s browser focus back on the action menu the user was on when they opened the modal.
# Any errors in the processing of a modal will display an error message in the message output area with a link back to the area the user was in when the error occurred.
# Selecting the ''Subscribe'' action will do the following things:
## Subscribe the user to the discussion to receive emails when new replies are created in the discussion
## Display a message in the message output stating that the user has been subscribed to the discussion
## Place the user’s browser focus on the message output.
# Selecting the ''Unsubscribe'' action will do the following things:
## Unsubscribe the user from the discussion and cause the user to stop receiving emails when new replies are created in the discussion
## Display a message in the message output stating that the user has been unsubscribed to the discussion
## Place the user’s browser focus on the message output.
# Selecting the ''Bookmark'' action will do the following things:
## Add the bookmark flag to the post
## Display a message in the message output stating that the post was bookmarked
## The message will end with a link to jump to the post that was bookmarked.
## Place the user’s browser focus on the message output
# Selecting the ''Remove bookmark'' action will do the following things:
## Remove the bookmark flag from the post
## Display a message in the message output stating that the bookmark has been removed from the post
## The message will end with a link to jump to the post that the bookmark was removed from.
## Place the user’s browser focus on the message output
## The message will end with a link to jump to the post that the bookmark was removed from.
# Selecting the ''Mark substantive'' action will do the following things:
## Add the substantive flag to the post
## Display a message in the message output stating that the post was flagged as substantive
## The message will end with a link to jump to the post that was flagged as substantive
## Place the user’s browser focus on the message output
# Selecting the ''Unmark substantive'' mark_ action will do the following things:
## Remove the substantive flag from the post
## Display a message in the message output stating that the substantive flag was removed from the post
## The message will end with a link to jump to the post the substantive flag was removed from.
## Place the user’s browser focus on the message output

===== Mockups =====

====== Discussion Display Pane Structure ======

[[Image:afDiscussionDisplayPaneStructure.png|afDiscussionDisplayPaneStructure.png]]

====== Discussion/Reply Structure ======

[[Image:afReplyStructure.png|afReplyStructure.png]]

====== Teacher Views Own Discussion ======

[[Image:afTeacherViewOwnDiscussion.png|afTeacherViewOwnDiscussion.png]]

====== Teacher Views Teacher Reply ======

[[Image:afTeacherViewTeacherReply.png|afTeacherViewTeacherReply.png]]

====== Teacher Views Student Reply ======

[[Image:afTeacherViewStudentReply.png|afTeacherViewStudentReply.png]]

====== Student Views Discussion ======

[[Image:afStudentViewDiscussion.png|afStudentViewDiscussion.png]]

====== Student Views Own Reply ======

[[Image:afStudentViewOwnReply.png|afStudentViewOwnReply.png]]

====== Teacher View Private Reply ======

[[Image:afPrivateReply.png|afPrivateReply.png]]

====== Anonymous Reply ======

[[Image:afAnonymousReply.png|afAnonymousReply.png]]

====== Student Reply Form Inline ======

[[Image:afStudentReplyModal.png|afStudentReplyModal.png]]

====== Teacher Reply Form Inline ======

[[Image:afTeacherReplyModal.png|afTeacherReplyModal.png]]

====== Rating Modal ======

[[Image:afRatingModal.png|afRatingModal.png]]

====== Split Post Modal ======

[[Image:afSplitModal.png|afSplitModal.png]]

====== Delete Post Modal ======

[[Image:afDeletePostModal.png|afDeletePostModal.png]]

====== Edit Reply Form Inline ======

[[Image:afEditModal.png|afEditModal.png]]

====== View Ratings Modal ======

[[Image:afViewRatingsModal.png|afViewRatingsModal.png]]

===== Use Cases =====

====== Student Listens to a Discussion Created by a Teacher ======

'''Description'''

A student selects a discussion using a screen reader and keyboard and listens to the screen reader read the discussion post.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the forum
# The student is using a screen reader
# The student has set the accessible forum display
# More than one discussion has been created by the teacher
# Replies have been posted to discussions

'''Steps'''

# The student uses the F6 key to get to the filter pane
# The student uses the F6 key to get to the forum and discussion pane
# The student uses the enter key to select the discussion

'''Postconditions'''

# The student is able to identify that the teacher created the discussion and not just another student.

====== Student Navigates Between Replies to a Discussion Using a Keyboard ======

'''Description'''

A student navigates between reply headings using the screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the forum
# The student is using a screen reader
# The student has set the accessible forum display
# More than one discussion has been created by the teacher
# The student has made a reply to a discussion

'''Steps'''

# The student uses the F6 key to get to the filter pane
# The student uses the F6 key to get to the forum and discussion pane
# The student uses the enter key to select the discussion
# The student uses the screen readers next header function to locate the next reply

'''Postconditions'''

# The student can identify by the header where they are within the forum hierarchy.
# The student is able to quickly navigate to each reply

====== Student Replies to a Discussion Using a Keyboard ======

'''Description'''

A student creates a reply to a discussion using a screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the forum
# The student is using a screen reader
# The student has set the accessible forum display
# More than one discussion has been created by the teacher
# Replies have been posted to discussions

'''Steps'''

# The student uses the F6 key to get to the filter pane
# The student uses the F6 key to get to the forum and discussion pane
# The student uses the enter key to select the discussion
# The student hits the tab key to tab to the action menu for the discussion
# The student hits the spacebar to open the action menu
# The student uses the down arrow to navigate to the reply action
# The student hits the enter key
# The student uses the tab key to tab through the forum fields and enter a reply
# The student tabs to the ''Post to forum'' button
# The student hits the enter key

'''Postconditions'''

# The reply is added to the discussion display pane in the proper place
# The student hears the header of the new reply

====== Student Edits a Reply Using a Keyboard ======

'''Description'''

A student edits a reply they have made using a screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the forum
# The student is using a screen reader
# The student has set the accessible forum display
# More than one discussion has been created by the teacher
# The student has made a reply to a discussion

'''Steps'''

# The student uses the F6 key to get to the filter pane
# The student uses the F6 key to get to the forum and discussion pane
# The student uses the enter key to select the discussion
# The student uses the screen readers next header keyboard commands to locate the reply they want to edit.
# The student hits the tab key to tab to the action menu for the discussion
# The student uses the spacebar to open the action menu
# The student uses the down arrow to select the edit menu item
# The student uses the enter key to select the edit menu item
# The student uses the tab key to navigate to the field they want to change
# The student uses the tab key to navigate to the ''Post to forum'' button
# The student hits the enter key to post the edits to the forum

'''Postconditions'''

# The reply is updated in the discussion display pane in the proper place
# The student hears the header of the edited reply

====== Student Subscribes to a Discussion Using a Keyboard ======

'''Description'''

A student subscribes to a discussion using a screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the forum
# The student is using a screen reader
# The student has set the accessible forum display
# More than one discussion has been created by the teacher
# The forum is set to optional forum subscriptions.
# The student is not subscribed to the forum
# The student has not subscribed to the discussion

'''Steps'''

# The student uses the F6 key to get to the filter pane
# The student uses the F6 key to get to the forum and discussion pane
# The student uses the enter key to select the discussion
# The student uses the screen readers next header keyboard commands to locate the reply they want to subscribe to.
# The student hits the tab key to tab to the action menu for the discussion
# The student uses the spacebar to open the action menu
# The student uses the down arrow to select the subscribe menu item
# The student uses the enter key to select the subscribe menu item

'''Postconditions'''

# The student is subscribed to the discussion
# A message is displayed in the message output area stating that the student has been subscribed to the discussion.
# The student hears the message

====== Student Accesses a Discussion’s Action Menu Using a Mouse ======

'''Description'''

A student displays a discussion’s action menu using a mouse.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the forum
# The student is using a screen reader
# The student has set the accessible forum display
# More than one discussion has been created by the teacher

'''Steps'''

# The student clicks on the discussion
# The student clicks on the action menu for the discussion

'''Postconditions'''

# The action menu expands

====== Teacher Rates a Post Using a Keyboard ======

'''Description'''

A teacher rates a student’s post using a screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a teacher
# An advanced forum has been created in the course
# The teacher has navigated to the course
# The teacher is using a screen reader
# The teacher has set the accessible forum display
# The teacher has created a discussion
# A student has made a reply to a discussion
# The forum is set to allow rating
# The student reply has not been rated

'''Steps'''

# The teacher uses the F6 key to get to the filter pane
# The teacher uses the F6 key to get to the forum and discussion pane
# The teacher uses the enter key to select the discussion
# The teacher uses the screen readers next header keyboard commands to locate the reply they want to rate.
# The teacher hits the tab key to tab to the action menu for the discussion
# The teacher uses the spacebar to open the action menu
# The teacher uses the down arrow to select the rate menu item
# The teacher uses the enter key to select the rate menu item
# The teacher uses the spacebar to open the rating select box
# The teacher uses the down arrow to select the rating they want.
# The teacher hits the enter key to select the rating for the post
# The teacher uses the tab key to navigate to the rate button.
# The teacher uses the enter key to rate the post.

'''Postconditions'''

# The post is rated
# The post’s rating is recalculated
# A message is displayed in the message output area stating that the post has been rated and allowing the teacher to jump to the post they rated.
# The student hears the message

====== Teacher Deletes a Discussion Using a Keyboard ======

'''Description'''

A teacher deletes a discussion using a screen reader and keyboard

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a teacher
# An advanced forum has been created in the course
# The teacher has navigated to the course
# The teacher is using a screen reader
# The teacher has set the accessible forum display
# A discussion has been created in the forum
# A reply has been made to the discussion

'''Steps'''

# The teacher uses the F6 key to get to the filter pane
# The teacher uses the F6 key to get to the forum and discussion pane
# The teacher uses the enter key to select the discussion
# The teacher hits the tab key to tab to the action menu for the discussion
# The teacher uses the spacebar to open the action menu
# The teacher uses the down arrow to select the delete menu item
# The teacher uses the enter key to select the delete menu item
# The teacher uses the spacebar to open the delete select box
# The teacher listens to the modal window text
# The teacher uses the tab key to navigate to the delete post button.
# The teacher uses the enter key to delete post button to delete the post.

'''Postconditions'''

# The post is deleted
# A message is displayed in the message output area stating that the post has been deleted and allowing the teacher to jump back to the forum and discussion pane
# The student hears the message

====== Teacher the Views Ratings for a Post Using a Keyboard ======

'''Description'''

A teacher views the ratings that have been given for a student’s post using a screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a teacher
# An advanced forum has been created in the course
# The teacher has navigated to the course
# The teacher is using a screen reader
# The teacher has set the accessible forum display
# The teacher has created a discussion
# A student has made a reply to a discussion
# The teacher and others have rated a student’s reply

'''Steps'''

# The teacher uses the F6 key to get to the filter pane
# The teacher uses the F6 key to get to the forum and discussion pane
# The teacher uses the enter key to select the discussion
# The teacher uses the screen readers next header keyboard commands to locate the reply they want to view the ratings for.
# The teacher hits the tab key to tab to the action menu for the discussion
# The teacher uses the spacebar to open the action menu
# The teacher uses the down arrow to select the view ratings menu item
# The teacher uses the enter key to select the view ratings menu item

'''Postconditions'''

# The view ratings modal appears with all the ratings that have been submitted for the post.

====== Teacher Splits a Reply Using a Keyboard ======

'''Description'''

A teacher splits a reply into a new discussion using a screen reader and keyboard

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a teacher
# An advanced forum has been created in the course
# The teacher has navigated to the course
# The teacher is using a screen reader
# The teacher has set the accessible forum display
# The teacher has created a discussion
# The reply has multiple replies to it.

'''Steps'''

# The teacher uses the F6 key to get to the filter pane
# The teacher uses the F6 key to get to the forum and discussion pane
# The teacher uses the enter key to select the discussion
# The teacher uses the screen readers next header keyboard commands to locate the reply they want to split.
# The teacher hits the tab key to tab to the action menu for the discussion
# The teacher uses the spacebar to open the action menu
# The teacher uses the down arrow to select the split menu item
# The teacher uses the enter key to select the split menu item
# The teacher uses the tab key to tab to the new discussion title field and enters a discussion title
# The teacher tabs to the split button
# The teacher hits the enter key to split the reply

'''Postconditions'''

# A new discussion is created from the reply with the title provided in the new discussion title field
# A message appears in the message output area that states the reply was split.
# The teacher’s browser focus is set to the message output
# The discussion display pane shows the newly created discussion
# The discussion tree in the forum and discussion pane is updated with the new discussion.

====== Teacher Marks a Post as Substantive Using a Keyboard ======

'''Description'''

A teacher marks a post as substantive using a screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a teacher
# An advanced forum has been created in the course
# The teacher has navigated to the course
# The teacher is using a screen reader
# The teacher has set the accessible forum display
# The teacher has created a discussion
# A student has made a reply to a discussion

'''Steps'''

# The teacher uses the F6 key to get to the filter pane
# The teacher uses the F6 key to get to the forum and discussion pane
# The teacher uses the enter key to select the discussion
# The teacher uses the screen readers next header keyboard commands to locate the reply they want mark as substantive.
# The teacher hits the tab key to tab to the action menu for the discussion
# The teacher uses the spacebar to open the action menu
# The teacher uses the down arrow to select the mark substantive menu item
# The teacher uses the enter key to select the mark substantive menu item

'''Postconditions'''

# The post is marked as substantive
# A message is added to the message output area stating that the post has been marked substantive and a link is included to allow the teacher to jump to the post.
# The teacher’s browser focus is placed on the message output.
# The teacher hears the message read to them.

====== Teacher Bookmarks a Post Using a Keyboard ======

'''Description'''

A teacher bookmarks a post using a screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a teacher
# An advanced forum has been created in the course
# The teacher has navigated to the course
# The teacher is using a screen reader
# The teacher has set the accessible forum display
# The teacher has created a discussion
# A student has made a reply to a discussion

'''Steps'''

# The teacher uses the F6 key to get to the filter pane
# The teacher uses the F6 key to get to the forum and discussion pane
# The teacher uses the enter key to select the discussion
# The teacher uses the screen readers next header keyboard commands to locate the reply they want to view the ratings for.
# The teacher hits the tab key to tab to the action menu for the discussion
# The teacher uses the spacebar to open the action menu
# The teacher uses the down arrow to select the bookmark menu item
# The teacher uses the enter key to select the bookmark menu item

'''Postconditions'''

# The post is flagged as bookmarked
# A message is added to the message output area stating that the post has been bookmarked and a link is included to allow the teacher to jump to the post.
# The teacher’s browser focus is placed on the message output.
# The teacher hears the message read to them.

=== Glossary ===

* '''Reply depth:''' The hierarchical level that a reply is on. A reply to a discussion is reply depth 1. A reply to a reply is depth 2. A reply to a reply to a reply is depth 3. Example: Discussion (depth 0) Reply (depth 1) Reply 2 (depth 2) Replay 3 (depth 3) Reply 4 (depth 2) Replay 5 (depth 1)

=== Document Change Management ===

==== Revision Summary ====

# Switched from a reply modal to an inline reply form to allow the user to navigate back up in the discussion hierarchy to listen to the post they are replying to.

==== Revision History ====

# Jason Hardin 20130812: Updated the specification to remove the reply modals and replace the references with inline forms. Updated some language to make the requirements make more sense.

=== Open Questions ===

# Is the breadcrumb required in Moodle for the forum?
# Does the breadcrumb need to be dynamically updated based on the user’s selection in the discussion tree?

==See also==
[[Category: Project]]

Advanced Forums Accessible Display Specification

2013-09-05T15:34:23Z

Psychoph:

=== Visioning ===

==== Overview ====

The Moodle forums is not as accessible as it could be. In order to improve usability of forums for those with disabilities Moodlerooms is will enhance advanced forums to display discussions based on EASI: Equal Access to Software & Information’s accessible forum design.

==== Business Goals ====

# Progress towards NFB Certification
# Keep strategic clients
# Improve sales for prospects with high accessibility requirements.

==== Product Goals ====

# Increase the accessibility of forum discussion display
# Increase usability of forums

==== Business References ====

* University of Montana (UofM)
* National Federation of the Blind (NFB)
* Department of Education
* [[http://easi.cc/|ASI: EQUAL ACCESS TO SOFTWARE & INFORMATION]]
* [[http://webaim.org/|WebAIM]]
* [[http://collaborate.athenpro.org/group/moodle/|Moodle Accessibility Group]]

=== Scenarios ===

==== Administrator Sets Advanced Forums as the Forums for All Forums on a Site ====

The administrator needs to force all forums to be created as advanced forums to meet the institutions accessibility policy. To do this the administrator sets all news forums to be created as advanced forums and disabled each roles capabilities to create forums.

==== Teacher Restricts Number of Replies ====

In order to keep forum conversations on topic the student wants to keep the depth of replies to a minimal. After a number of replies to replies a user will not be able to create a reply to a reply.

==== A Visually Impaired Student Listens to Posts in a Course Forum ====

A student needs to review the new posts that students and students have posted to their course forums. Using a screen reader the student accesses the forum and listens to the replies that have been made in the forum.

==== A Visually Impaired Student Replies to a Post in a Course Forum ====

A student wants to reply to a discussion made by the student. Using a screen reader the student navigates to the discussion and hits return when they find the reply link. The student is then placed in a text editor to create their reply. The student then saves the reply by navigating to the post button.

==== A Visually Impaired Student Sorts Forum Discussions ====

A student wants to sort the discussions by which have the newest posts in order to understand what the latest changes are to the forum. The student navigates to the sort using a screen reader and hits enter when they have found the sort by newest post.

=== References ===

==== Jira ====

==== Technical ====

* [[http://easi.cc/archive/bb2013/recording/index.htm|Recording of a discussion on the accessible prototype (EASI)]]
* [[https://dl.dropboxusercontent.com/u/137779786/discussion_module_mockup/discussion_board-listview.html|Prototype of an accessible forum (ESAI) ]]
* [[http://www.oaa-accessibility.org/examples/|OpenAjax Accessibility examples]]
* [[http://webaim.org/techniques/keyboard/accesskey|WebAIM on keyboard shortcuts]]

=== Feature Information ===

==== Advanced Forums Site Settings ====

===== Description =====

Advanced forums will allow administrators to set the default forum display (renamed from discussion display) for all users. Advanced forums will also allow a site administrator to set the default maximum reply depth.

===== Requirements =====

# Rename Discussion display to Forum display in advanced forums display types.
# A new checkbox administrative settings called Create news forums as advanced forums will be added to the activity’s administrative settings page. See [[#AdvancedForumAdministrativeSettings|Mockup: Advanced Forum Administrative Settings]]
# The default value for the Create news forums as advanced forums is unchecked aka no.
# A new select box administrative settings called Default forum display will be added to the activity’s administrative settings page. See [[#AdvancedForumAdministrativeSettings|Mockup: Advanced Forum Administrative Settings]]
# The default value for the Default forum display is default
# The possible values for the Default forum display will be:
## Accessible
## Default
## Nested
## Tree
# A new administrative settings called Maximum reply depth will be added to the activity’s administrative settings page. See [[#AdvancedForumAdministrativeSettings|Mockup: Advanced Forum Administrative Settings]]
# The maximum reply depth will use a drop-down and have the values 1-10 and then the final value of unlimited.
# The default value for the Maximum reply depth will be 3. See [[#AdvancedForumAdministrativeSettings|Mockup: Advanced Forum Administrative Settings]]

===== Mockups =====

====== Advanced Forum Administrative Settings ======

[[Image:afAdminSettings.png|afAdminSettings.png]]

===== Use Cases =====

====== Administrator Sets Default Forum Display ======

'''Description'''

The administrator sets the default forum display to accessible.

'''Preconditions'''

# The user is logged in
# The user is assigned as a site administrator
# The user is at the site level

'''Steps'''

# The administrator clicks on the ''Plugins'' link group under the Settings block
# The administrator clicks on the ''Activity modules'' link group
# The administrator clicks on the ''Advanced forums'' link
# The administrator selects ''Accessible'' from the ''Default forum display'' select box
# The administrator clicks the ''Save changes'' button

'''Postconditions'''

# the settings are saved

====== Administrator Sets the Site to Create all News Forums as Advanced Forums ======

'''Description'''

The administrator sets the site to use advanced forums for all newly created news forums.

'''Preconditions'''

# The user is logged in
# The user is assigned as a site administrator
# The user is at the site level

'''Steps'''

# The administrator clicks on the ''Plugins'' link group under the Settings block
# The administrator clicks on the ''Activity modules'' link group
# The administrator clicks on the ''Advanced forums'' link
# The administrator clicks the checkbox to the left of Create all new forums as advanced forums
# The administrator clicks the ''Save changes'' button

'''Postconditions'''

# The settings are saved

====== Administrator Sets the Default Maximum Reply Depth ======

'''Description'''

The administrator sets the default maximum reply depth for all newly created forums to be 1.

'''Preconditions'''

# The user is logged in
# The user is assigned as a site administrator
# The user is at the site level

'''Steps'''

# The administrator clicks on the ''Plugins'' link group under the Settings block
# The administrator clicks on the ''Activity modules'' link group
# The administrator clicks on the ''Advanced forums'' link
# The administrator selects 1 in the text box to the right of the Maximum reply depth setting.
# The administrator clicks the ''Save changes'' button

'''Postconditions'''

# The settings are saved.

====== Administrator Creates a Course With an Advanced Forums News Forum ======

'''Description'''

The administrator creates a course with a news forum. The news forum is created as an advanced forum.

'''Preconditions'''

# The user is logged in
# The user is assigned as a site administrator
# The advanced forum setting create news forums as advanced forums is checked.
# The user is at the site level

'''Steps'''

# The administrator clicks the ''Courses'' link group
# The administrator clicks the ''Add/edit courses'' link
# The administrator clicks the ''Add a new course'' button
# The administrator fills out the course information
# The administrator clicks the ''Save changes'' button

'''Postconditions'''

# The news forum created for the course is an advanced forum.

==== Advanced Forum Accessible Settings ====

===== Description =====

A new setting will be added to the create a forum screen that will allow the student to restrict the maximum depth of replies for a discussion.

===== Requirements =====

# A new setting will be added to the create a forum screen under the general group called maximum [[#replydepth|reply depth]]. See [[#AdvancedForumDepthSetting|Mockup: Advanced Forum Depth Setting]]
# The default value for the maximum [[#replydepth|reply depth]] will be 3
# The maximum [[#replydepth|reply depth]] will be unlimited
# Once the [[#replydepth|reply depth]] in a discussion reaches maximum reply depth the a student will not be able to reply to the reply. See [[#MaximumReplyDepthDisplay|Mockup: Maximum Reply Depth Display]]
# When a teacher creates a reply to the maximum depth reply the reply will be marked automatically as a private reply.
# A teacher will be unable to uncheck the private reply checkbox for a reply to a reply at the maximum reply depth. See [[#TeacherReplytoaMaximumDepthReply|Mockup: Teacher Reply to a Maximum Depth Reply]]
# On upgrade all existing advanced forums will have their maximum reply depth set to unlimited.

===== Mockups =====

====== Advanced Forum Depth Setting ======

[[Image:afMaxDepthSetting.png|afMaxDepthSetting.png]]

====== Maximum Reply Depth Display ======

[[Image:afMaxReplyDepthDisplay.png|afMaxReplyDepthDisplay.png]]

====== Teacher Reply to a Maximum Depth Reply ======

[[Image:afMaxReplyPrivateReply.png|afMaxReplyPrivateReply.png]]

===== Use Cases =====

====== Teacher Creates a Forum with a Maximum Reply Depth of 2 ======

'''Description'''

The teacher wants to limit the reply depth to 2 to keep the teachers on track with the forum discussion.

'''Preconditions'''

# The user is logged in
# The users is assigned the teacher role in the course
# The user has navigated to the course
# The course is set to weeks or topics format

'''Steps'''

# The teacher clicks on the add activity link
# The teacher selects Advanced forum
# The teacher fills out the forum information
# The teacher selects 2 from the select box for maximum reply depth

'''Postconditions'''

# Users cannot reply to a reply or a reply
# The teacher can still create a private reply to a reply of a reply

====== A Student Views a Reply at the Maximum Reply Depth ======

'''Description'''

A student views a reply that is at the maximum reply depth.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course with a maximum reply depth
# The forum has multiple replies with one at the maximum reply depth
# The student has navigated to the course

'''Steps'''

# The student clicks on the forum
# The student scrolls to the reply at the maximum reply depth

'''Postconditions'''

# The student doesn’t see the reply link.

====== A Teacher Replies to a Maximum Reply Depth Reply ======

'''Description'''

The student wants to create a private reply to the student’s reply even though it is at the maximum reply depth.

'''Preconditions'''

# The user is logged in
# The user is assigned to the student role in a course
# An advanced forum has been created in the course with a maximum reply depth
# The forum has multiple replies with one at the maximum reply depth
# The student has navigated to the course

'''Steps'''

# The student clicks on the forum
# The student scrolls to the reply at the maximum reply depth
# The student clicks on the reply link
# The student fills out the reply form
# The student clicks the ''Post to forum'' button

'''Postconditions'''

# The Private reply checkbox is checked and disabled
# The student can’t change the reply to a non private reply.

==== Private Reply Display ====

===== Description =====

To improve the accessibility of private replies Moodlerooms will add a string to the front of private replies to identify them to the user.

===== Requirements =====

# Private replies will have the string Private reply: added to the front of the title for the reply. See [[#PrivateReplyDisplay|Mockup: Private Reply Display]]
# The string Private reply will be translatable.

===== Mockups =====

====== Private Reply Display ======

[[Image:afPrivateReply.png|afPrivateReply.png]]

===== Use Cases =====

====== Student Views a Private Reply ======

'''Description'''

A student views a private reply from a student in a forum.

'''Preconditions'''

# The user is logged in
# The user is assigned to the student role in a course
# The student has created a reply in a forum
# A student has created a private reply to the student’s reply
# The user has navigated to a course with a private reply in it

'''Steps'''

# The student clicks on the forum
# The student scrolls to view the private reply

'''Postconditions'''

# The string Private reply shows in front of the title for the reply.

==== Accessible Discussion Display ====

===== Description =====

The current display options in advanced forums do not maximize the view for those with disabilities. The accessible discussion display will work to implement the prototype of an accessible forum by ESAI. Users will be able to switch between this discussion display and any other discussion display types.

===== Requirements =====

[test]

# A new discussion display mode will be added to the forum display drop down called accessible.
# The accessible forum display will be separated into 5 areas (See [[#AccessibleDisplayStructure|Mockup: Accessible Display Structure]])
## Moodle breadcrumb at the top
## Filter pane at the top
## Forum description (Only shown if set)
## Forum and Discussion selection pane on the left
## Discussion display pane on the right
# Forum management will still be maintained within Moodle’s navigation and settings blocks and accessed via the themes block display.
# The breadcrumb will initially display the full moodle path to the forum the user selected within the course. See [[#NoDiscussionSelected|Mockup: No Discussion Selected]]
# The user will be able to use skip navigation to jump to the forum/discussion pane. See [[#AccessibleDisplayStructure|Mockup: Accessible Display Structure]]
# Navigation from the Discussion display pane to the Forum and Discussion selection pane
# The access key 1 will be used to move to the focus to the Forum select box
# The access key 2 will be used to move the focus to the discussion selection tree view
# The F6 key will be used to to switch focus to the next pane of the filter, forum and discussion and the discussion display panes. See [[#AccessibleDisplayStructure|Mockup: Accessible Display Structure]]
# The Shift+F6 keys will be used to switch focus to the previous pane of the filter, forum and discussion and the discussion display panes. See [[#AccessibleDisplayStructure|Mockup: Accessible Display Structure]]
# When navigating between panes a screen reader will be informed of the region the user has navigated to.

====== Accessible Display Structure ======

[[Image:afAccessibleDisplayStructure.png|afAccessibleDisplayStructure.png]]

====== No Discussion Selected ======

[[Image:afNoDiscussionSelected.png|afNoDiscussionSelected.png]]

===== Use Cases =====

====== Student Selects Accessible Forum Display ======

'''Description'''

A student will a visual disability wants to maximize their usability of advanced forums and selects the accessible forum display type.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course with a maximum reply depth
# The student has navigated to the course
# The student is using a screen reader

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the screen reader to skip to the main content of the page
# The student tabs to the forum display select drop down
# The student uses the space button to open the the select drop down
# The student uses the arrow keys to highlight the accessible select option
# The student hits the enter key

'''Postconditions'''

# The page reloads
# The accessible forum display appears

====== Student Uses F6 to Navigate Between Panes ======

'''Description'''

A visually impaired user wants to quickly change between the panes in the accessible forum view using the F6 key.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student hits the F6 key

'''Postconditions'''

# The student is taken to the filter pane
# The student is informed they are in the filter region

====== Student Uses Shift+F6 to Navigate Between Panes ======

'''Description'''

A student wants to navigate back through the panes of the accessible forum display using the shift+F6 key combination.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student hits the Shift+F6 key combination

'''Postconditions'''

# The student is taken to the discussion display pane
# The student is informed they are in the discussion display region

====== Student Uses Access key 1 to Navigate to the Forum Selection box ======

'''Description'''

A student wants to jump directory to the forum selector to change the forum they are viewing.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student clicks the screen reader’s key combination for the access 1 key

'''Postconditions'''

# The keyboard focus is set of the forum selector box box

====== Student Uses Access key 2 to Navigate to the Discussion Selection Tree view ======

'''Description'''

A student wants to jump to the discussion tree selector to quickly select a new reply to listen to.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student clicks the screen reader’s key combination for the access 2 key

'''Postconditions'''

# The keyboard focus is set of the discussion selector tree view box

==== Accessible Forum Display Filter Pane ====

===== Description =====

In order to quickly access the information users need from the forums they will need to be able to sort and filter the discussions in the forum. Users will also need to be able to change the forum display to their preferred display from the default or current display.

===== Requirements =====

{note}See original [Specs 2.4 Advanced Forums] for how discussions are sorted using each sort by type{note}

# The filter pane will display the following menus based on the forum configuration for the teacher: (See [[#FilterPaneExpandedTeacher|Mockup: Filter Pane Expanded Teacher]])
## Group menu (only displayed if visible or separate groups is set for the forum)
### All participants
### List of all groups in the grouping assigned to the forum.
## Sort by (each menu item will have a sub menu for changing the sort to ascending or descending)
### Last post date
### Creation date
### Last name
### First name
### Number of replies
## Forum display
### Accessible
### Default
### Nested
### Tree
# The filter pane will display the following menus based on the forum configuration for the student: (See [[#FilterPaneExpandedStudent|Mockup: Filter Pane Expanded Student]])
## Sort by (each menu item will have a sub menu for changing the sort to ascending or descending)
### Last post date
### Creation date
### Last name
### First name
### Number of replies
## Forum display
### Accessible
### Default
### Nested
### Tree
# The filter pane will display the simple forum search form for all users. See [[#FilterPane|Mockup: Filter Pane]]
# The user will be able to tab to the first menu and the search field
# The user will use the left and right arrows to switch between menus and to open sub menus
# The user will use the up and down arrows to navigate between menu items
# The user will use the spacebar to open the menu
# Selecting a sort by option will open up the ascending or descending sub menu. See [[#FilterPaneExpandedStudent|Mockup: Filter Pane Expanded Student]]
# Selecting ascending or descending in a sort by submenu will rest the discussion display pane to its default state. See [[#NoDiscussionSelected|Mockup: No Discussion Selected]]
# Selecting ascending or descending in a sort by submenu will rest the page’s Moodle breadcrumb to the path to the current forum. See [[#NoDiscussionSelected|Mockup: No Discussion Selected]]
# Selecting ascending or descending will sort the discussion list based on the sort by and ascending or descending selection.
# Selecting ascending or descending will set the student’s focus to the Discussion tree view.
# If the forum is not set to use groups in the forum settings then the view group menu in the top navigation will not display. See [[#FilterPaneExpandedStudent|Mockup: Filter Pane Expanded Student]]
# Selecting a group in the view group selector will change the discussion pane to display only discussions for that group and all participants.
# Selecting a group in the view group selector will focus the user on the Discussion tree view
# Selecting a group will reset the discussion view pane to its default state of no discussion or reply being displayed. See [[#NoDiscussionSelected|Mockup: No Discussion Selected]]
# Selecting a group will reset the Moodle breadcrumb to the path to the current forum. See [[#NoDiscussionSelected|Mockup: No Discussion Selected]]
# Selecting a display type in the forum display menu will cause the page to reload and the new forum display to display the forum. See [[#NoDiscussionSelected|Mockup: No Discussion Selected]]
# Clicking the ''Search'' button will bring up the search results in the discussion display pane. See [[#SearchResults|Mockup: Search Results]]
# The search one the filter pane will search only the current forum.
# Clicking the ''Advanced search'' button will display the Advanced search modal. See [[#AdvancedSearchModal|Mockup: Advanced Search Modal]]
# The advanced search modal will lock the user’s keyboard in the modal until the user click the ''Close'', ''Cancel'', or ''Search forums'' button.
# Clicking the ''Search'' button on the filter pane or the ''Search forums'' button in the advanced search modal will display the search results in the discussion display pane. See [[#SearchResults|Mockup: Search Results]]
# The user’s browser focus will be placed on the discussion display pane after a search has finished.
# The search results will display the same as described in the [[#AccessibleForumDiscussionDisplayPane|Section: Accessible Forum Discussion Display Pane]] with a header titled Search results with a count of the number of posts found.
# The action menu for each post in the search results will consist of the following links: (See [[#SearchResults|Mockup: Search Results]])
## Show post in full discussion
## Show post and its replies
# Selecting Show post in full discussion in the action menu will cause the following to happen:
## The discussion display pane will display all posts in the discussion the post is in.
## The user’s browser focus will be placed on the post in the discussion display pane
# Selecting Show post and its replies in the action menu will cause the following to happen:
## The discussion display pane display the post and all replies to the post in the discussion hierarchy.
## The user’s browser focus will be placed on the post in the discussion display pane

===== Mockups =====

====== Filter Pane ======

[[Image:afFilterPane.png|afFilterPane.png]]

====== Filter Pane Expanded Teacher ======

[[Image:afFilterPaneExpandedTeacher.png|afFilterPaneExpandedTeacher.png]]

====== Filter Pane Expanded Student ======

[[Image:afFilterPaneExpandedStudent.png|afFilterPaneExpandedStudent.png]]

====== Search Results ======

[[Image:afSearchResults.png|afSearchResults.png]]

====== Advanced Search Modal ======

[[Image:afAdvancedSearchModal.png|afAdvancedSearchModal.png]]

===== Use Cases =====

====== Student Accesses the Sort by Menu Using a Keyboard ======

'''Description'''

A student accesses the sort by menu drop down using a screen reader and their keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the screen reader to jump to the main content
# The student uses the tab key to tab to the sort by menu

'''Postconditions'''

# Using the tab key the student is able to find the sort by menu
# The student is able to identify using the screen reader which menu they are on.

====== Student Accesses the Search Field Using a Keyboard ======

'''Description'''

A student accesses the search input field using a screen reader and their keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the screen reader to jump to the main content
# The student uses the tab key to tab to the search input field

'''Postconditions'''

# The student is able to identify that entering text in the field will search to forum for posts with that information in it.
# The student is able to identify they are in a form and need to tab to the ''Search forum'' button

====== Student Opens Sort By Menu Using a Keyboard ======

'''Description'''

A student opens the sort by menu using a screen reader and their keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the screen reader to jump to the main content
# The student uses the tab key to tab to the sort by menu
# The student uses the spacebar to open the sort by menu

'''Postconditions'''

# The sort by menu opens for the student
# The screen reader reads all of the sort by menu items.

====== Student Selects Sort By Number of Replies Descending Using a Keyboard ======

'''Description'''

A student selects sort by number or replies in a descending order using a screen reader and their keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display
# The advanced forum has more than 1 discussion and reply

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the screen reader to jump to the main content
# The student uses the tab key to tab to the sort by menu
# The student uses the spacebar to open the sort by menu
# The student uses the down arrow key to locate the ''Number of replies'' menu item
# The student uses the right arrow key to open the ''Number of replies'' sub menu
# The student uses the down arrow key to select the ''Descending'' menu item

'''Postconditions'''

# The discussion list is resorted by number of replies in a descending order
# The student’s browser focus is set to the discussion tree view
# The student is able to understand via the screen reader that they are not accessing the discussion tree view.

====== Student Navigates Between Menus Using a Keyboard ======

'''Description'''

A student accesses each menu using a keyboard and screen reader.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the screen reader to jump to the main content
# The student uses the tab key to tab to the sort by menu
# The student uses the left arrow key to navigate to the forum display menu

'''Postconditions'''

# The student is able to navigate to the forum display using the keyboard

====== Student Selects a Display Type Using a Keyboard ======

'''Description'''

A student changes the display type from accessible to default using a screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the screen reader to jump to the main content
# The student uses the tab key to tab to the sort by menu
# The student uses the left arrow key to navigate to the forum display menu
# The student uses the spacebar to open the forum display menu
# The student uses the down arrow key to select a new forum display type

'''Postconditions'''

# The student is able to navigate to the forum display using the keyboard
# The page is reloaded and the forum is displayed using the new forum display type

====== Teacher Selects a Group Using a Keyboard ======

'''Description'''

A teacher filters the lists of discussions by group using a screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a teacher
# An advanced forum has been created in the course
# The teacher has navigated to the course
# The teacher is using a screen reader
# The teacher has set the accessible forum display
# The advanced forum is setup to have separate groups
# Students are assigned to groups
# The forum has posts to each group as well as all participants.

'''Steps'''

# The teacher uses the screen reader to skip to the main content of the course
# The teacher tabs to the forum activity within the course
# The teacher hits the enter key
# The teacher uses the screen reader to jump to the main content
# The teacher uses the tab key to tab to the sort by menu
# The teacher uses the left arrow key to navigate to the view group menu
# The teacher uses the spacebar to open the view group menu
# The teacher uses the down arrow key to select a group to view

'''Postconditions'''

# The discussion tree view is updated with the discussions available to the selected group and all participants
# The teacher’s browser focus is set to the discussion tree view.

====== Student Searches the Forum Using a Keyboard ======

'''Description'''

A student uses a screen reader and keyboard to access the search input field in the filter pane and search the forum.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display
# There are discussion in the forum
# There are replies in the forum
# There are replies or discussions that match the search criteria in the forum.

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the F6 key to navigate to the filter pane
# The student tabs to the search input field
# The student enters their search text in the search input field
# The student tabs to the search button
# The student hits the enter key to search the forums

'''Postconditions'''

# The posts that are found matching the search criteria display in the discussion display pane
# The user’s browser focus is set to the discussion display pane.

====== Student Uses the Advanced Search to Search the Forum Using a Keyboard ======

'''Description'''

A student search the forum using the advanced search modal, a screen reader and a keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display
# There are discussion in the forum
# There are replies in the forum
# There are replies or discussions that match the search criteria in the forum.

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the F6 key to navigate to the filter pane
# The student tabs to the advanced search button
# The student hits the enter key
# The student uses the tab key to fill out the search criteria
# The student tabs to the search forum button
# The student hits enter to search the forum

'''Postconditions'''

# The posts that are found matching the search criteria display in the discussion display pane
# The user’s browser focus is set to the discussion display pane.

====== Student Displays the Discussion the Search Result is a Part of Using a Keyboard ======

'''Description'''

A student selects the to view the discussion that a search result post is a part of using a screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display
# There are discussion in the forum
# There are replies in the forum
# There are replies or discussions that match the search criteria in the forum.
# The user has finished searching via advanced search or simple search.

'''Steps'''

# The student uses the screen readers next header keyboard commands to locate the reply they want to edit.
# The student hits the tab key to tab to the action menu for the discussion
# The student uses the spacebar to open the action menu
# The student uses the down arrow to select the Show post in full discussion menu item
# The student uses the enter key to select the Show post in full discussion menu item

'''Postconditions'''

# The discussion pane displays the discussion that the post is in
# The user’s bowser focus is set to the post that Show post in full discussion was selected for.

====== Student Displays the Search Result and All Replies Using a Keyboard ======

'''Description'''

A student selects to display the search result post and all of its replies using a screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display
# There are discussion in the forum
# There are replies in the forum
# There are replies or discussions that match the search criteria in the forum.
# The user has finished searching via advanced search or simple search.

'''Steps'''

# The student uses the screen readers next header keyboard commands to locate the reply they want to edit.
# The student hits the tab key to tab to the action menu for the discussion
# The student uses the spacebar to open the action menu
# The student uses the down arrow to select the Show post and its replies menu item
# The student uses the enter key to select the Show post and its replies menu item

'''Postconditions'''

# The discussion pane displays the post and all of its sub replies
# The user’s bowser focus is set to the post that Show post and its replies was selected for.

==== Accessible Forum Display Forum and Discussion Pane ====

===== Description =====

The forum and discussion pane is designed to provide the user with quick access to overall activity within the forum. This is where the user quickly navigates to the discussion or reply they want to view in the discussion pane.

===== Requirements =====

# The Forum and discussion pane will display the following: (See [[#ForumandDiscussionPane|Mockup: Forum and Discussion Pane]])
## A drop down list of all forums in the course with the current forum selected
## A button to ''Add a new discussion topic''
## If visible or separate groups is set for the forum a statement of the setting will display below the forum select box. See [[#ForumandDiscussionPaneSeparateGroups|Mockup: Forum and Discussion Pane Separate Groups]] and [[#ForumandDiscussionPaneVisibleGroups|Mockup: Forum and Discussion Pane Visible Groups]]
## An expandable collapsable list of all discussions and replies in the currently selected forum the user can view.
# The forum selector drop down will not appear if there is only one forum in the course
# The forum selector will list all advanced forums in the course in alphabetical order
# Selecting a forum from the forum drop down will reload the page as if the user had clicked on the forum in the course.
# The ''Add a new discussion topic'' button will not appear for users if they do not have permissions to create a discussion.
# Clicking the ''Add a new discussion topic'' will display the ''Your new discussion topic'' forum in the discussion pane. See [[#NewDiscussionTopic|Mockup: New Discussion Topic]]
# Clicking the ''Post to forum'' button in the ''Your new discussion topic'' form causes the following to happen:
## Save the discussion to the forum
## Add the discussion title in the correct sort order to the discussion tree
## Display the new discussion in the discussion pane
## Place the browser focus on the new discussion.
# Clicking the ''Cancel'' button will cause the following to happen:
## Close the reset the discussion pane to the default state when no discussion is selected
## Return the user’s browser focus to the ''Add a new discussion topic'' button.
# The user will use tab to navigate between the forum selector, add a new discussion topic button and discussion tree.
# A group selector option will display below the mail now form field if a forum is set to separate or visible groups.
# The user will use the up and down arrows to navigate up and down in the discussion tree. See [[#ForumandDiscussionPaneExpanded|Mockup: Forum and Discussion Pane Expanded]]
# The user will use the left and right arrows to expand and contract the discussion tree. See [[#ForumandDiscussionPaneExpanded|Mockup: Forum and Discussion Pane Expanded]]
# The user will be able to use the mouse to click on the + and - images to expand and contract discussions and replies. See [[#ForumandDiscussionPaneExpanded|Mockup: Forum and Discussion Pane Expanded]]
# Discussions that are collapsed and have replies will have a + image to the left of the discussion title and the screen reader will read that the discussion is collapsed. See [[#ForumandDiscussionPaneExpanded|Mockup: Forum and Discussion Pane Expanded]]
# Replies that are collapsed and have replies will have a + image to the left of the reply title and the screen reader will read that the reply is collapsed. See [[#ForumandDiscussionPaneExpanded|Mockup: Forum and Discussion Pane Expanded]]
# Discussions that are expanded and have replies will have a - image to the left of the discussion title and the screen reader will read that the discussion is expanded. See [[#ForumandDiscussionPaneExpanded|Mockup: Forum and Discussion Pane Expanded]]
# Replies that are expanded and have replies will have a - image to the left of the reply title and the screen reader will read that the reply is expanded. See [[#ForumandDiscussionPaneExpanded|Mockup: Forum and Discussion Pane Expanded]]
# When expanded a discussion or reply will display all replies to the discussion in tree form below it. See [[#ForumandDiscussionPaneExpanded|Mockup: Forum and Discussion Pane Expanded]]
# If a discussion or reply has no replies to it then no image will display to the left of the title. See [[#ForumandDiscussionPaneExpanded|Mockup: Forum and Discussion Pane Expanded]]
# Users will use the enter key on a discussion to display the discussion and all replies in the discussion pane. See [[#DiscussionAccessibleDisplay|Mockup: Discussion Accessible Display]]
# Users will click on a discussion to display the discussion and all replies in the discussion pane. See [[#DiscussionAccessibleDisplay|Mockup: Discussion Accessible Display]]
# Users will use the enter key on a reply to display the reply and all replies to the reply in the discussion pane. See [[#SelectedReplyAccessibleDisplay|Mockup: Selected Reply Accessible Display]]
# Users will click on a reply to display the replies and all replies to the reply in the discussion pane. See [[#SelectedReplyAccessibleDisplay|Mockup: Selected Reply Accessible Display]]
# Clicking on a reply or discussion will place the user’s browser focus on the discussion pane
# Hitting the enter key on a discussion or reply link will place the user’s browser focus on the discussion pane.
# The discussion tree will display the number of unread replies for the discussion/reply to the right of the discussion/reply title if the user has read tracking enabled. See [[#ForumandDiscussionPane|Mockup: Forum and Discussion Pane]]
# Forums set to visible or separate groups will add the for and group name to the right of the discussion title when the post is set to a specific group in the discussion tree view. See [[#ForumandDiscussionPaneSeparateGroups|Mockup: Forum and Discussion Pane Separate Groups]] and [[#ForumandDiscussionPaneVisibleGroups|Mockup: Forum and Discussion Pane Visible Groups]]

===== Mockups =====

====== Forum and Discussion Pane ======

[[Image:afForumDiscussionPane.png|afForumDiscussionPane.png]]

====== Forum and Discussion Pane Expanded ======

[[Image:afForumDiscussionPaneExpanded.png|afForumDiscussionPaneExpanded.png]]

====== Forum and Discussion Pane Separate Groups ======

[[Image:afForumDiscussionPaneSeparateGroups.png|afForumDiscussionPaneSeparateGroups.png]]

====== Forum and Discussion Pane Visible Groups ======

[[Image:afForumDiscussionPaneVisibleGroups.png|afForumDiscussionPaneVisibleGroups.png]]

====== Discussion Accessible Display ======

[[Image:afAccessibleDiscussionDisplay.png|afAccessibleDiscussionDisplay.png]]

====== Selected Reply Accessible Display ======

[[Image:afAccessibleReplyDisplay.png|afAccessibleReplyDisplay.png]]

====== New Discussion Topic ======

[[Image:afNewTopicModal.png|afNewTopicModal.png]]

===== Use Cases =====

====== Student Uses a Keyboard to Navigate Between Forum and Discussion Panel Areas ======

'''Description'''

A student navigates between the forum selector, add a new discussion topic and the discussion tree using a screen reader and their keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the F6 key to get to the filter pane
# The student uses the F6 key to get to the forum and discussion pane
# The student uses the tab key to navigate between the areas of the forum and discussion pane

'''Postconditions'''

# The student is able to navigate between the forum selector and discussion tree areas
# The student with the use of the screen reader understands the areas they are navigating between.

====== Student Selects a Different Forum Using a Keyboard ======

'''Description'''

A student navigates to a different forum without going back to the course page using a screen reader and their keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display
# The is more than one forum in the course

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the F6 key to get to the filter pane
# The student uses the F6 key to get to the forum and discussion pane
# The student tabs to the forum selector
# The student uses the spacebar to open the forum selector
# The student uses the down arrow to select the next forum in the course
# The student hits the enter key to select the forum

'''Postconditions'''

# The page is reloaded and the student is in the accessible view of the selected forum.

====== Teacher Adds a New Discussion Topic Using a Keyboard ======

'''Description'''

A teacher with a visual disability adds a new discussion topic to the forum using their screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a teacher
# An advanced forum has been created in the course
# The teacher has navigated to the course
# The teacher is using a screen reader
# The teacher has set the accessible forum display

'''Steps'''

# The teacher uses the screen reader to skip to the main content of the course
# The teacher tabs to the forum activity within the course
# The teacher hits the enter key
# The teacher uses the F6 key to get to the filter pane
# The teacher uses the F6 key to get to the forum and discussion pane
# The teacher uses the tab key to navigate to the ''Add a new discussion topic'' button
# The teacher hit the enter key
# The teacher uses tab to fill in all field in the ''Your new discussion topic'' form
# The teacher tabs to the ''Post to forum'' button
# The teacher hits the enter key

'''Postconditions'''

# The teacher’s post is saved
# The teacher’s browser focus is placed on the discussion pane.
# The discussion tree is updated with the new discussion.

====== Teacher Adds a New Discussion Topic For a Specific Group Using a Keyboard ======

'''Description'''

A teacher with a visual disability adds a new discussion topic to the forum using their screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a teacher
# An advanced forum has been created in the course
# The teacher has navigated to the course
# The teacher is using a screen reader
# The teacher has set the accessible forum display
# The advanced forum is set to separate groups

'''Steps'''

# The teacher uses the screen reader to skip to the main content of the course
# The teacher tabs to the forum activity within the course
# The teacher hits the enter key
# The teacher uses the F6 key to get to the filter pane
# The teacher uses the F6 key to get to the forum and discussion pane
# The teacher uses the tab key to navigate to the ''Add a new discussion topic'' button
# The teacher hit the enter key
# The teacher uses tab to fill in all field in the ''Your new discussion topic'' form
# The teacher selects a specific group from the group selector
# The teacher tabs to the ''Post to forum'' button
# The teacher hits the enter key

'''Postconditions'''

# The teacher’s post is saved
# The teacher’s browser focus is placed back on discussion pane.
# The discussion tree is updated with the new discussion.
# The discussion title has the words for <group name selected> to its right.

====== Student Expands a Discussion Using a Keyboard ======

'''Description'''

A student expands a discussion to listen to all of the replies to the discussion using a screen reader and their keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display
# More than one discussion has been created
# Replies have been posted to discussions

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the F6 key to get to the filter pane
# The student uses the F6 key to get to the forum and discussion pane
# The student uses the tab key to navigate to the discussion tree
# The student uses the left arrow key to expand the replies to the discussion

'''Postconditions'''

# All the titles for the replies of reply depth 1 for the discussion are showing and read to the user via the screen reader

====== Student Expands a Discussion Using a Mouse ======

'''Description'''

A student expands the replies to a discussion using their mouse.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student has set the accessible forum display
# More than one discussion has been created
# Replies have been posted to discussions

'''Steps'''

# The student clicks on the forum in the course
# The student clicks on the plus image to the left of the discussion title

'''Postconditions'''

# All the titles for the replies of reply depth 1 for the discussion are displayed

====== Student Navigated Down the Discussion Tree Using a Keyboard ======

'''Description'''

A student navigates to a reply to a discussion using a screen reader and their keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display
# More than one discussion has been created
# Replies have been posted to discussions

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the F6 key to get to the filter pane
# The student uses the F6 key to get to the forum and discussion pane
# The student uses the tab key to navigate to the discussion tree
# The student uses the down arrow to navigate to the next discussion in the tree

'''Postconditions'''

# The title of the discussion is read to the student via the screen reader

====== Student Selects a Discussion to Display Using a Keyboard ======

'''Description'''

A student selects a discussion using a screen reader and their keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display
# More than one discussion has been created
# Replies have been posted to discussions

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the F6 key to get to the filter pane
# The student uses the F6 key to get to the forum and discussion pane
# The student uses the tab key to navigate to the discussion tree
# The student uses the down arrow to navigate to the next discussion
# The student hits the enter key

'''Postconditions'''

# The student’s browser focus is set to the discussion pane
# The discussion pane is updated to display the full discussion plus all replies in the discussion.

====== Student Selects a Discussion Using a Mouse ======

'''Description'''

A student selects a discussion using their mouse.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student has set the accessible forum display
# More than one discussion has been created
# Replies have been posted to discussions

'''Steps'''

# The student clicks on the forum in the course
# The student clicks on the discussion title

'''Postconditions'''

# The student’s browser focus is set to the discussion pane
# The discussion pane is updated to display the full discussion plus all replies in the discussion.

====== Student Locates a Discussion With Unread Replies using a Keyboard ======

'''Description'''

A student navigates through the discussion tree until they hear a discussion that has new replies to it. The student is using the screen reader and their keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display
# More than one discussion has been created
# Replies have been posted to discussions

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the F6 key to get to the filter pane
# The student uses the F6 key to get to the forum and discussion pane
# The student uses the down arrow to located a discussion with unread replies

'''Postconditions'''

# Each discussion title is read as the user uses the down arrow to navigate down
# The discussion title is read then the number of unread replies.

====== Student Selects a Reply Using a Keyboard ======

'''Description'''

A student navigates to a reply and selects it to listen to in the discussion pane using a screen reader and their keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display
# More than one discussion has been created
# Replies have been posted to discussions

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the F6 key to get to the filter pane
# The student uses the F6 key to get to the forum and discussion pane
# The student uses the right arrow to expand a discussion
# The student hits the enter key

'''Postconditions'''

# The student’s browser focus is set to the discussion pane
# The discussion pane is updated to display the reply and all replies of a reply depth below the starting reply.

====== Student Selects a Reply Using a Mouse ======

'''Description'''

A student navigates to a reply and selects it to listen to in the discussion pane using their mouse.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student has set the accessible forum display
# More than one discussion has been created
# Replies have been posted to discussions

'''Steps'''

# The student clicks on the forum in the course
# The student clicks on the plus image to the left of the discussion title
# The student clicks on the reply title

'''Postconditions'''

# The student’s browser focus is set to the discussion pane
# The discussion pane is updated to display the reply and all replies of a reply depth below the starting reply.

==== Accessible Forum Discussion Display Pane ====

===== Description =====

The discussion display pane is the region of the forum that displays to the user the specific discussion or reply they have chosen with all sub replies. The pane is designed to present the selected discussion or reply in the most accessible manner focusing on simplified content and easy tabbing between actions. HTML headers are used to help inform the user where they are in the hierarchy of the discussion.

{note}It is understood that using HTML header’s to denote the hierarchy of the forum has the issue that HTML only has a header level up to H6. Furthermore H1 is only used once on a page and for the page heading. This is why the maximum reply depth setting has been added. It also should be noted that after a reply depth of 3 forum replies become less focused on the original discussion topic.{note}

===== Requirements =====

# The discussion pane will be separated into 2 areas: (See [[#DiscussionDisplayPaneStructure|Mockup: Discussion Display Pane Structure]])
## Message display area. This is a live area that is updated with message as information is added or removed.
## Discussion/reply display area. This is dynamically updated based on content changes and the forum and discussion pane.
# Messages in the message area will display for 30 seconds and then be removed from the page.
# The message output area will not be accessible by keyboard if there are no messages displayed within the area.
# Each discussion or reply will be separated into 3 areas: (See [[#Discussion/ReplyStructure|Mockup: Discussion/Reply Structure]])
## Heading
## Post
### Post text
### File attachments
## Actions
# A discussion/reply heading will display the following information in this order: (See [[#TeacherViewsOwnDiscussion|Mockup: Teacher Views Own Discussion]])
## Post title using the correct HTML header based on reply depth (see below)
## Author with their image and name, the image will not be identified to a screen reader (alt=“”)
## Post date, the date the post was created
## Rating type and value (this will only display if ratings are enabled for the forum)
# The accessible display mode will use HTML header tags (h2-h6) for the title of the discussion post and replies. See [[#DiscussionAccessibleDisplay|Mockup: Discussion Accessible Display]]
# The discussion post will use a h2 HTML header tag for the title of the post. See [[#DiscussionAccessibleDisplay|Mockup: Discussion Accessible Display]]
# A replies reply depth will determine the HTML header tag to be used for the title: (See [[#DiscussionAccessibleDisplay|Mockup: Discussion Accessible Display]])
## Reply depth 1 will use the HTML header h3
## Reply depth 2 will use the HTML header h4
## Reply depth 3 will use the HTML header h5
## Reply depth 4 will use the HTML header h6
# Forums that allow a reply depth greater then 4 will use the HTML Header tag of H6 for all reply titles at a depth of 4 or greater.
# The post text area will display the post text and then any file attachments in an unordered list below the post text. See [[#Discussion/ReplyStructure|Mockup: Discussion/Reply Structure]]
# If there are no actions the user can perform on the post then the action area and menu will not display
# When the forum is set to separate groups and a discussion is set to all participants the action area and action menu will not display to students.
# Replies in the discussion pane will display based on the reply hierarchy and depth.
# If the teacher is the creator of the discussion or reply their name will be denoted in bold and the screen reader will read “Teacher” before reading the poster’s name.
# Anywhere in the below action menus if the action is subscribe it will be replaced with unsubscribe if the user is already subscribed to the discussion.
# Anywhere in the below action menus if the action bookmark is available the option remove bookmark will show if the discussion or reply is already bookmarked
# Anywhere in the below action menus if the action mark substantive is available the option Unmark substantive will show if the discussion or reply is already marked as substantive.
# Reply will display in the below action menus only if the user has permissions to create a reply
# Rating and view ratings will only display in the action menus if the rating setting is enabled for the forum.
# A teacher will have the following actions available when viewing their own discussion: (See [[#TeacherViewsOwnDiscussion|Mockup: Teacher Views Own Discussion]])
## Edit
## Delete
## View ratings (only displays if ratings are enabled for the forum)
## Subscribe (will not display if subscribed to the forum or forum subscription is disabled)
## Mark substantive
## Bookmark
## Reply
# A teacher will have the following actions available when viewing their own reply: (See [[#TeacherViewsTeacherReply|Mockup: Teacher Views Teacher Reply]])
## Edit
## Split
## Delete
## View ratings (only displays if ratings are enabled for the forum)
## Mark substantive
## Bookmark
## Reply
# A teacher will have the following actions available when viewing a student’s reply: (See [[#TeacherViewsStudentReply|Mockup: Teacher Views Student Reply]])
## Reply
## Split
## Delete
## Rate (only displays if ratings are enabled for the forum)
## Mark substantive
## Bookmark
# A student will have the following actions available when viewing a discussion: (See [[#StudentViewsDiscussion|Mockup: Student Views Discussion]])
## Reply
## Rate
## Subscribe
# A student will have the following actions available when viewing their own reply: (See [[#StudentViewsOwnReply|Mockup: Student Views Own Reply]])
## Edit
## Delete
## Reply
# A private reply will display only to the student who created the original reply and the teachers.
# A teacher will have the following options available when viewing a private reply: (See [[#TeacherViewPrivateReply|Mockup: Teacher View Private Reply]])
## Edit
## Split
## Delete
# The action area and menu will not display to a student for a private reply.
# The user’s picture will display as the default user picture for an anonymous forum. See ([[#AnonymousReply|Mockup: Anonymous Reply]])
# The user’s name will appear as a Anonymous user instead of the creators real name.
# A user will have all the same action menu menu items for an anonymous reply as they would for a reply of the same type in a regular forum.
# A user will be able to use the spacebar to open the action menu
# A user will be able to use the tab key to navigate to a post’s action menu
# A user will be able to use the enter key to select an action menu item.
# Selecting the reply action will bring up the reply form below the post the user is replying to.
# The student reply modal will have the fields in [[#StudentReplyFormInline|Mockup: Student Reply Form Inline]]
# The file upload area will not display if the forum is set to not allow attachments.
# The teacher reply form will have the following additional form fields compared to a student’s reply form based on the type of forum and the forum settings: See ([[#TeacherReplyFormInline|Mockup: Teacher Reply Form Inline]])
## Mail now
## Group (select box with available groups if the forum is set to visible or separate groups)
## Private reply
## Reveal yourself in this post (if the forum is set to anonymous)
# Clicking the ''Post to forum'' button in the reply form will cause the following things to happen:
## The reply is added as the last reply to the post the user selected reply for
## The discussion tree view is updated to reflect the added reply if the parent post is expanded
## The user’s browser focus is placed on the header of the newly created reply.
# Clicking the ''Cancel'' button in the reply form will cause the following things to happen:
## The reply form stops displaying inline below the current post
## The user’s browser focus is placed on the header of the post the user was replying to.
# Selecting the split action will bring up the split post modal. See ([[#SplitPostModal|Mockup: Split Post Modal]])
# The split post modal will key the keyboard locked in the modal until the user clicks the ''Close'', ''Cancel'', or ''Split'' button.
# Clicking the ''Split'' button in the split modal will cause the following things to happen:
## The Split post modal to close
## The post converted to the initial discussion post for the new discussion with the title in the new discussion title field of the modal
## The reply hierarchy for the post are still associated with the post
## The discussion display pane will display the new discussion that the post was split into.
## The user’s browser focus is placed on the header for the initial post of the new discussion
## The discussion tree in the forum and discussion pane is updated to reflect the changes to the forum hierarchy
# Selecting the delete action will bring up a conformation that the user wants to delete the reply or discussion. See ([[#DeleteReplyModal|Mockup: Delete Reply Modal]])
# Clicking the ''Delete post'' button in the delete post modal will do the following things:
## Close the modal
## Remove the post and the reply in the hierarchy attached to the post and lower.
## Add a message to the message output stating “The <post header> was successfully deleted”.
## The user’s browser focus will be placed on the success message.
# The delete post modal will keep the keyboard locked in the modal until the user clicks the ''Close'', ''Cancel'', or ''Delete post'' button.
# Selecting the edit action will bring up the reply form inline pre-populated with the post that is being edited. See ([[#EditReplyForumInline|Mockup: Edit Reply Form Inline]])
# Selecting the rate action will bring up the rate modal pre-populated with the current rating the user has given the post. See [[#RatingModal|Mockup: Rating Modal]]
# The rate post modal will key the keyboard locked in the modal until the user clicks the ''Close'', ''Cancel'', or ''Rate post'' button.
# Clicking the ''Rate'' button in the rate modal will cause the following things to happen:
## The rate post modal will close
## The rating the user had entered will be saved for the post
## The rating for the post will update based on the forum settings.
## A message will be added the message output area stating “The rating was successfully saved” with a link to jump back to the post within the discussion display panel.
# Selecting the view ratings action will bring up the view ratings modal. See ([[#ViewRatingsModal|Mockup: View Ratings Modal]])
# The view ratings modal will keep the user’s keyboard focus until the user clicking on the ''Close'' or ''Close this window'' button.
# Closing a modal using the ''Close'', ''Close this window'' or ''Cancel'' buttons will place the user’s browser focus back on the action menu the user was on when they opened the modal.
# Any errors in the processing of a modal will display an error message in the message output area with a link back to the area the user was in when the error occurred.
# Selecting the ''Subscribe'' action will do the following things:
## Subscribe the user to the discussion to receive emails when new replies are created in the discussion
## Display a message in the message output stating that the user has been subscribed to the discussion
## Place the user’s browser focus on the message output.
# Selecting the ''Unsubscribe'' action will do the following things:
## Unsubscribe the user from the discussion and cause the user to stop receiving emails when new replies are created in the discussion
## Display a message in the message output stating that the user has been unsubscribed to the discussion
## Place the user’s browser focus on the message output.
# Selecting the ''Bookmark'' action will do the following things:
## Add the bookmark flag to the post
## Display a message in the message output stating that the post was bookmarked
## The message will end with a link to jump to the post that was bookmarked.
## Place the user’s browser focus on the message output
# Selecting the ''Remove bookmark'' action will do the following things:
## Remove the bookmark flag from the post
## Display a message in the message output stating that the bookmark has been removed from the post
## The message will end with a link to jump to the post that the bookmark was removed from.
## Place the user’s browser focus on the message output
## The message will end with a link to jump to the post that the bookmark was removed from.
# Selecting the ''Mark substantive'' action will do the following things:
## Add the substantive flag to the post
## Display a message in the message output stating that the post was flagged as substantive
## The message will end with a link to jump to the post that was flagged as substantive
## Place the user’s browser focus on the message output
# Selecting the ''Unmark substantive'' mark_ action will do the following things:
## Remove the substantive flag from the post
## Display a message in the message output stating that the substantive flag was removed from the post
## The message will end with a link to jump to the post the substantive flag was removed from.
## Place the user’s browser focus on the message output

===== Mockups =====

====== Discussion Display Pane Structure ======

[[Image:afDiscussionDisplayPaneStructure.png|afDiscussionDisplayPaneStructure.png]]

====== Discussion/Reply Structure ======

[[Image:afReplyStructure.png|afReplyStructure.png]]

====== Teacher Views Own Discussion ======

[[Image:afTeacherViewOwnDiscussion.png|afTeacherViewOwnDiscussion.png]]

====== Teacher Views Teacher Reply ======

[[Image:afTeacherViewTeacherReply.png|afTeacherViewTeacherReply.png]]

====== Teacher Views Student Reply ======

[[Image:afTeacherViewStudentReply.png|afTeacherViewStudentReply.png]]

====== Student Views Discussion ======

[[Image:afStudentViewDiscussion.png|afStudentViewDiscussion.png]]

====== Student Views Own Reply ======

[[Image:afStudentViewOwnReply.png|afStudentViewOwnReply.png]]

====== Teacher View Private Reply ======

[[Image:afPrivateReply.png|afPrivateReply.png]]

====== Anonymous Reply ======

[[Image:afAnonymousReply.png|afAnonymousReply.png]]

====== Student Reply Form Inline ======

[[Image:afStudentReplyModal.png|afStudentReplyModal.png]]

====== Teacher Reply Form Inline ======

[[Image:afTeacherReplyModal.png|afTeacherReplyModal.png]]

====== Rating Modal ======

[[Image:afRatingModal.png|afRatingModal.png]]

====== Split Post Modal ======

[[Image:afSplitModal.png|afSplitModal.png]]

====== Delete Post Modal ======

[[Image:afDeletePostModal.png|afDeletePostModal.png]]

====== Edit Reply Form Inline ======

[[Image:afEditModal.png|afEditModal.png]]

====== View Ratings Modal ======

[[Image:afViewRatingsModal.png|afViewRatingsModal.png]]

===== Use Cases =====

====== Student Listens to a Discussion Created by a Teacher ======

'''Description'''

A student selects a discussion using a screen reader and keyboard and listens to the screen reader read the discussion post.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the forum
# The student is using a screen reader
# The student has set the accessible forum display
# More than one discussion has been created by the teacher
# Replies have been posted to discussions

'''Steps'''

# The student uses the F6 key to get to the filter pane
# The student uses the F6 key to get to the forum and discussion pane
# The student uses the enter key to select the discussion

'''Postconditions'''

# The student is able to identify that the teacher created the discussion and not just another student.

====== Student Navigates Between Replies to a Discussion Using a Keyboard ======

'''Description'''

A student navigates between reply headings using the screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the forum
# The student is using a screen reader
# The student has set the accessible forum display
# More than one discussion has been created by the teacher
# The student has made a reply to a discussion

'''Steps'''

# The student uses the F6 key to get to the filter pane
# The student uses the F6 key to get to the forum and discussion pane
# The student uses the enter key to select the discussion
# The student uses the screen readers next header function to locate the next reply

'''Postconditions'''

# The student can identify by the header where they are within the forum hierarchy.
# The student is able to quickly navigate to each reply

====== Student Replies to a Discussion Using a Keyboard ======

'''Description'''

A student creates a reply to a discussion using a screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the forum
# The student is using a screen reader
# The student has set the accessible forum display
# More than one discussion has been created by the teacher
# Replies have been posted to discussions

'''Steps'''

# The student uses the F6 key to get to the filter pane
# The student uses the F6 key to get to the forum and discussion pane
# The student uses the enter key to select the discussion
# The student hits the tab key to tab to the action menu for the discussion
# The student hits the spacebar to open the action menu
# The student uses the down arrow to navigate to the reply action
# The student hits the enter key
# The student uses the tab key to tab through the forum fields and enter a reply
# The student tabs to the ''Post to forum'' button
# The student hits the enter key

'''Postconditions'''

# The reply is added to the discussion display pane in the proper place
# The student hears the header of the new reply

====== Student Edits a Reply Using a Keyboard ======

'''Description'''

A student edits a reply they have made using a screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the forum
# The student is using a screen reader
# The student has set the accessible forum display
# More than one discussion has been created by the teacher
# The student has made a reply to a discussion

'''Steps'''

# The student uses the F6 key to get to the filter pane
# The student uses the F6 key to get to the forum and discussion pane
# The student uses the enter key to select the discussion
# The student uses the screen readers next header keyboard commands to locate the reply they want to edit.
# The student hits the tab key to tab to the action menu for the discussion
# The student uses the spacebar to open the action menu
# The student uses the down arrow to select the edit menu item
# The student uses the enter key to select the edit menu item
# The student uses the tab key to navigate to the field they want to change
# The student uses the tab key to navigate to the ''Post to forum'' button
# The student hits the enter key to post the edits to the forum

'''Postconditions'''

# The reply is updated in the discussion display pane in the proper place
# The student hears the header of the edited reply

====== Student Subscribes to a Discussion Using a Keyboard ======

'''Description'''

A student subscribes to a discussion using a screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the forum
# The student is using a screen reader
# The student has set the accessible forum display
# More than one discussion has been created by the teacher
# The forum is set to optional forum subscriptions.
# The student is not subscribed to the forum
# The student has not subscribed to the discussion

'''Steps'''

# The student uses the F6 key to get to the filter pane
# The student uses the F6 key to get to the forum and discussion pane
# The student uses the enter key to select the discussion
# The student uses the screen readers next header keyboard commands to locate the reply they want to subscribe to.
# The student hits the tab key to tab to the action menu for the discussion
# The student uses the spacebar to open the action menu
# The student uses the down arrow to select the subscribe menu item
# The student uses the enter key to select the subscribe menu item

'''Postconditions'''

# The student is subscribed to the discussion
# A message is displayed in the message output area stating that the student has been subscribed to the discussion.
# The student hears the message

====== Student Accesses a Discussion’s Action Menu Using a Mouse ======

'''Description'''

A student displays a discussion’s action menu using a mouse.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the forum
# The student is using a screen reader
# The student has set the accessible forum display
# More than one discussion has been created by the teacher

'''Steps'''

# The student clicks on the discussion
# The student clicks on the action menu for the discussion

'''Postconditions'''

# The action menu expands

====== Teacher Rates a Post Using a Keyboard ======

'''Description'''

A teacher rates a student’s post using a screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a teacher
# An advanced forum has been created in the course
# The teacher has navigated to the course
# The teacher is using a screen reader
# The teacher has set the accessible forum display
# The teacher has created a discussion
# A student has made a reply to a discussion
# The forum is set to allow rating
# The student reply has not been rated

'''Steps'''

# The teacher uses the F6 key to get to the filter pane
# The teacher uses the F6 key to get to the forum and discussion pane
# The teacher uses the enter key to select the discussion
# The teacher uses the screen readers next header keyboard commands to locate the reply they want to rate.
# The teacher hits the tab key to tab to the action menu for the discussion
# The teacher uses the spacebar to open the action menu
# The teacher uses the down arrow to select the rate menu item
# The teacher uses the enter key to select the rate menu item
# The teacher uses the spacebar to open the rating select box
# The teacher uses the down arrow to select the rating they want.
# The teacher hits the enter key to select the rating for the post
# The teacher uses the tab key to navigate to the rate button.
# The teacher uses the enter key to rate the post.

'''Postconditions'''

# The post is rated
# The post’s rating is recalculated
# A message is displayed in the message output area stating that the post has been rated and allowing the teacher to jump to the post they rated.
# The student hears the message

====== Teacher Deletes a Discussion Using a Keyboard ======

'''Description'''

A teacher deletes a discussion using a screen reader and keyboard

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a teacher
# An advanced forum has been created in the course
# The teacher has navigated to the course
# The teacher is using a screen reader
# The teacher has set the accessible forum display
# A discussion has been created in the forum
# A reply has been made to the discussion

'''Steps'''

# The teacher uses the F6 key to get to the filter pane
# The teacher uses the F6 key to get to the forum and discussion pane
# The teacher uses the enter key to select the discussion
# The teacher hits the tab key to tab to the action menu for the discussion
# The teacher uses the spacebar to open the action menu
# The teacher uses the down arrow to select the delete menu item
# The teacher uses the enter key to select the delete menu item
# The teacher uses the spacebar to open the delete select box
# The teacher listens to the modal window text
# The teacher uses the tab key to navigate to the delete post button.
# The teacher uses the enter key to delete post button to delete the post.

'''Postconditions'''

# The post is deleted
# A message is displayed in the message output area stating that the post has been deleted and allowing the teacher to jump back to the forum and discussion pane
# The student hears the message

====== Teacher the Views Ratings for a Post Using a Keyboard ======

'''Description'''

A teacher views the ratings that have been given for a student’s post using a screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a teacher
# An advanced forum has been created in the course
# The teacher has navigated to the course
# The teacher is using a screen reader
# The teacher has set the accessible forum display
# The teacher has created a discussion
# A student has made a reply to a discussion
# The teacher and others have rated a student’s reply

'''Steps'''

# The teacher uses the F6 key to get to the filter pane
# The teacher uses the F6 key to get to the forum and discussion pane
# The teacher uses the enter key to select the discussion
# The teacher uses the screen readers next header keyboard commands to locate the reply they want to view the ratings for.
# The teacher hits the tab key to tab to the action menu for the discussion
# The teacher uses the spacebar to open the action menu
# The teacher uses the down arrow to select the view ratings menu item
# The teacher uses the enter key to select the view ratings menu item

'''Postconditions'''

# The view ratings modal appears with all the ratings that have been submitted for the post.

====== Teacher Splits a Reply Using a Keyboard ======

'''Description'''

A teacher splits a reply into a new discussion using a screen reader and keyboard

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a teacher
# An advanced forum has been created in the course
# The teacher has navigated to the course
# The teacher is using a screen reader
# The teacher has set the accessible forum display
# The teacher has created a discussion
# The reply has multiple replies to it.

'''Steps'''

# The teacher uses the F6 key to get to the filter pane
# The teacher uses the F6 key to get to the forum and discussion pane
# The teacher uses the enter key to select the discussion
# The teacher uses the screen readers next header keyboard commands to locate the reply they want to split.
# The teacher hits the tab key to tab to the action menu for the discussion
# The teacher uses the spacebar to open the action menu
# The teacher uses the down arrow to select the split menu item
# The teacher uses the enter key to select the split menu item
# The teacher uses the tab key to tab to the new discussion title field and enters a discussion title
# The teacher tabs to the split button
# The teacher hits the enter key to split the reply

'''Postconditions'''

# A new discussion is created from the reply with the title provided in the new discussion title field
# A message appears in the message output area that states the reply was split.
# The teacher’s browser focus is set to the message output
# The discussion display pane shows the newly created discussion
# The discussion tree in the forum and discussion pane is updated with the new discussion.

====== Teacher Marks a Post as Substantive Using a Keyboard ======

'''Description'''

A teacher marks a post as substantive using a screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a teacher
# An advanced forum has been created in the course
# The teacher has navigated to the course
# The teacher is using a screen reader
# The teacher has set the accessible forum display
# The teacher has created a discussion
# A student has made a reply to a discussion

'''Steps'''

# The teacher uses the F6 key to get to the filter pane
# The teacher uses the F6 key to get to the forum and discussion pane
# The teacher uses the enter key to select the discussion
# The teacher uses the screen readers next header keyboard commands to locate the reply they want mark as substantive.
# The teacher hits the tab key to tab to the action menu for the discussion
# The teacher uses the spacebar to open the action menu
# The teacher uses the down arrow to select the mark substantive menu item
# The teacher uses the enter key to select the mark substantive menu item

'''Postconditions'''

# The post is marked as substantive
# A message is added to the message output area stating that the post has been marked substantive and a link is included to allow the teacher to jump to the post.
# The teacher’s browser focus is placed on the message output.
# The teacher hears the message read to them.

====== Teacher Bookmarks a Post Using a Keyboard ======

'''Description'''

A teacher bookmarks a post using a screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a teacher
# An advanced forum has been created in the course
# The teacher has navigated to the course
# The teacher is using a screen reader
# The teacher has set the accessible forum display
# The teacher has created a discussion
# A student has made a reply to a discussion

'''Steps'''

# The teacher uses the F6 key to get to the filter pane
# The teacher uses the F6 key to get to the forum and discussion pane
# The teacher uses the enter key to select the discussion
# The teacher uses the screen readers next header keyboard commands to locate the reply they want to view the ratings for.
# The teacher hits the tab key to tab to the action menu for the discussion
# The teacher uses the spacebar to open the action menu
# The teacher uses the down arrow to select the bookmark menu item
# The teacher uses the enter key to select the bookmark menu item

'''Postconditions'''

# The post is flagged as bookmarked
# A message is added to the message output area stating that the post has been bookmarked and a link is included to allow the teacher to jump to the post.
# The teacher’s browser focus is placed on the message output.
# The teacher hears the message read to them.

=== Glossary ===

* '''Reply depth:''' The hierarchical level that a reply is on. A reply to a discussion is reply depth 1. A reply to a reply is depth 2. A reply to a reply to a reply is depth 3. Example: Discussion (depth 0) Reply (depth 1) Reply 2 (depth 2) Replay 3 (depth 3) Reply 4 (depth 2) Replay 5 (depth 1)

=== Document Change Management ===

==== Revision Summary ====

# Switched from a reply modal to an inline reply form to allow the user to navigate back up in the discussion hierarchy to listen to the post they are replying to.

==== Revision History ====

# Jason Hardin 20130812: Updated the specification to remove the reply modals and replace the references with inline forms. Updated some language to make the requirements make more sense.

=== Open Questions ===

# Is the breadcrumb required in Moodle for the forum?
# Does the breadcrumb need to be dynamically updated based on the user’s selection in the discussion tree?

==See also==
[[Category: Project]]

Advanced Forums Accessible Display Specification

2013-09-04T20:55:34Z

Psychoph:

=== Visioning ===

==== Overview ====

The Moodle forums is not as accessible as it could be. In order to improve usability of forums for those with disabilities Moodlerooms is will enhance advanced forums to display discussions based on EASI: Equal Access to Software & Information’s accessible forum design.

==== Business Goals ====

# Progress towards NFB Certification
# Keep strategic clients
# Improve sales for prospects with high accessibility requirements.

==== Product Goals ====

# Increase the accessibility of forum discussion display
# Increase usability of forums

==== Business References ====

* University of Montana (UofM)
* National Federation of the Blind (NFB)
* Department of Education
* [[http://easi.cc/|ASI: EQUAL ACCESS TO SOFTWARE & INFORMATION]]
* [[http://webaim.org/|WebAIM]]
* [[http://collaborate.athenpro.org/group/moodle/|Moodle Accessibility Group]]

=== Scenarios ===

==== Administrator Sets Advanced Forums as the Forums for All Forums on a Site ====

The administrator needs to force all forums to be created as advanced forums to meet the institutions accessibility policy. To do this the administrator sets all news forums to be created as advanced forums and disabled each roles capabilities to create forums.

==== Teacher Restricts Number of Replies ====

In order to keep forum conversations on topic the student wants to keep the depth of replies to a minimal. After a number of replies to replies a user will not be able to create a reply to a reply.

==== A Visually Impaired Student Listens to Posts in a Course Forum ====

A student needs to review the new posts that students and students have posted to their course forums. Using a screen reader the student accesses the forum and listens to the replies that have been made in the forum.

==== A Visually Impaired Student Replies to a Post in a Course Forum ====

A student wants to reply to a discussion made by the student. Using a screen reader the student navigates to the discussion and hits return when they find the reply link. The student is then placed in a text editor to create their reply. The student then saves the reply by navigating to the post button.

==== A Visually Impaired Student Sorts Forum Discussions ====

A student wants to sort the discussions by which have the newest posts in order to understand what the latest changes are to the forum. The student navigates to the sort using a screen reader and hits enter when they have found the sort by newest post.

=== References ===

==== Jira ====

==== Technical ====

* [[http://easi.cc/archive/bb2013/recording/index.htm|Recording of a discussion on the accessible prototype (EASI)]]
* [[https://dl.dropboxusercontent.com/u/137779786/discussion_module_mockup/discussion_board-listview.html|Prototype of an accessible forum (ESAI) ]]
* [[http://www.oaa-accessibility.org/examples/|OpenAjax Accessibility examples]]
* [[http://webaim.org/techniques/keyboard/accesskey|WebAIM on keyboard shortcuts]]
* [Specs 2.4 Advanced Forums]

=== Feature Information ===

==== Advanced Forums Site Settings ====

===== Description =====

Advanced forums will allow administrators to set the default forum display (renamed from discussion display) for all users. Advanced forums will also allow a site administrator to set the default maximum reply depth.

===== Requirements =====

# Rename Discussion display to Forum display in advanced forums display types.
# A new checkbox administrative settings called Create news forums as advanced forums will be added to the activity’s administrative settings page. See [[#AdvancedForumAdministrativeSettings|Mockup: Advanced Forum Administrative Settings]]
# The default value for the Create news forums as advanced forums is unchecked aka no.
# A new select box administrative settings called Default forum display will be added to the activity’s administrative settings page. See [[#AdvancedForumAdministrativeSettings|Mockup: Advanced Forum Administrative Settings]]
# The default value for the Default forum display is default
# The possible values for the Default forum display will be:
## Accessible
## Default
## Nested
## Tree
# A new administrative settings called Maximum reply depth will be added to the activity’s administrative settings page. See [[#AdvancedForumAdministrativeSettings|Mockup: Advanced Forum Administrative Settings]]
# The default value for the Maximum reply depth will be 3. See [[#AdvancedForumAdministrativeSettings|Mockup: Advanced Forum Administrative Settings]]

===== Mockups =====

====== Advanced Forum Administrative Settings ======

[[Image:afAdminSettings.png|afAdminSettings.png]]

===== Use Cases =====

====== Administrator Sets Default Forum Display ======

'''Description'''

The administrator sets the default forum display to accessible.

'''Preconditions'''

# The user is logged in
# The user is assigned as a site administrator
# The user is at the site level

'''Steps'''

# The administrator clicks on the ''Plugins'' link group under the Settings block
# The administrator clicks on the ''Activity modules'' link group
# The administrator clicks on the ''Advanced forums'' link
# The administrator selects ''Accessible'' from the ''Default forum display'' select box
# The administrator clicks the ''Save changes'' button

'''Postconditions'''

# the settings are saved

====== Administrator Sets the Site to Create all News Forums as Advanced Forums ======

'''Description'''

The administrator sets the site to use advanced forums for all newly created news forums.

'''Preconditions'''

# The user is logged in
# The user is assigned as a site administrator
# The user is at the site level

'''Steps'''

# The administrator clicks on the ''Plugins'' link group under the Settings block
# The administrator clicks on the ''Activity modules'' link group
# The administrator clicks on the ''Advanced forums'' link
# The administrator clicks the checkbox to the left of Create all new forums as advanced forums
# The administrator clicks the ''Save changes'' button

'''Postconditions'''

# The settings are saved

====== Administrator Sets the Default Maximum Reply Depth ======

'''Description'''

The administrator sets the default maximum reply depth for all newly created forums to be 1.

'''Preconditions'''

# The user is logged in
# The user is assigned as a site administrator
# The user is at the site level

'''Steps'''

# The administrator clicks on the ''Plugins'' link group under the Settings block
# The administrator clicks on the ''Activity modules'' link group
# The administrator clicks on the ''Advanced forums'' link
# The administrator enters 1 in the text box to the right of the Maximum reply depth setting.
# The administrator clicks the ''Save changes'' button

'''Postconditions'''

# The settings are saved.

====== Administrator Creates a Course With an Advanced Forums News Forum ======

'''Description'''

The administrator creates a course with a news forum. The news forum is created as an advanced forum.

'''Preconditions'''

# The user is logged in
# The user is assigned as a site administrator
# The advanced forum setting create news forums as advanced forums is checked.
# The user is at the site level

'''Steps'''

# The administrator clicks the ''Courses'' link group
# The administrator clicks the ''Add/edit courses'' link
# The administrator clicks the ''Add a new course'' button
# The administrator fills out the course information
# The administrator clicks the ''Save changes'' button

'''Postconditions'''

# The news forum created for the course is an advanced forum.

==== Advanced Forum Accessible Settings ====

===== Description =====

A new setting will be added to the create a forum screen that will allow the student to restrict the maximum depth of replies for a discussion.

===== Requirements =====

# A new setting will be added to the create a forum screen under the general group called maximum [[#replydepth|reply depth]]. See [[#AdvancedForumDepthSetting|Mockup: Advanced Forum Depth Setting]]
# The default value for the maximum [[#replydepth|reply depth]] will be 3
# The maximum [[#replydepth|reply depth]] will be 7
# Once the [[#replydepth|reply depth]] in a discussion reaches maximum reply depth the a student will not be able to reply to the reply. See [[#MaximumReplyDepthDisplay|Mockup: Maximum Reply Depth Display]]
# When a teacher creates a reply to the maximum depth reply the reply will be marked automatically as a private reply.
# A teacher will be unable to uncheck the private reply checkbox for a reply to a reply at the maximum reply depth. See [[#TeacherReplytoaMaximumDepthReply|Mockup: Teacher Reply to a Maximum Depth Reply]]

===== Mockups =====

====== Advanced Forum Depth Setting ======

[[Image:afMaxDepthSetting.png|afMaxDepthSetting.png]]

====== Maximum Reply Depth Display ======

[[Image:afMaxReplyDepthDisplay.png|afMaxReplyDepthDisplay.png]]

====== Teacher Reply to a Maximum Depth Reply ======

[[Image:afMaxReplyPrivateReply.png|afMaxReplyPrivateReply.png]]

===== Use Cases =====

====== Teacher Creates a Forum with a Maximum Reply Depth of 2 ======

'''Description'''

The teacher wants to limit the reply depth to 2 to keep the teachers on track with the forum discussion.

'''Preconditions'''

# The user is logged in
# The users is assigned the teacher role in the course
# The user has navigated to the course
# The course is set to weeks or topics format

'''Steps'''

# The teacher clicks on the add activity link
# The teacher selects Advanced forum
# The teacher fills out the forum information
# The teacher selects one from the select box for maximum reply depth

'''Postconditions'''

# Users cannot reply to a reply or a reply
# The teacher can still create a private reply to a reply of a reply

====== A Student Views a Reply at the Maximum Reply Depth ======

'''Description'''

A student views a reply that is at the maximum reply depth.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course with a maximum reply depth
# The forum has multiple replies with one at the maximum reply depth
# The student has navigated to the course

'''Steps'''

# The student clicks on the forum
# The student scrolls to the reply at the maximum reply depth

'''Postconditions'''

# The student doesn’t see the reply link.

====== A Teacher Replies to a Maximum Reply Depth Reply ======

'''Description'''

The student wants to create a private reply to the student’s reply even though it is at the maximum reply depth.

'''Preconditions'''

# The user is logged in
# The user is assigned to the student role in a course
# An advanced forum has been created in the course with a maximum reply depth
# The forum has multiple replies with one at the maximum reply depth
# The student has navigated to the course

'''Steps'''

# The student clicks on the forum
# The student scrolls to the reply at the maximum reply depth
# The student clicks on the reply link
# The student fills out the reply form
# The student clicks the ''Post to forum'' button

'''Postconditions'''

# The Private reply checkbox is checked and disabled
# The student can’t change the reply to a non private reply.

==== Private Reply Display ====

===== Description =====

To improve the accessibility of private replies Moodlerooms will add a string to the front of private replies to identify them to the user.

===== Requirements =====

# Private replies will have the string Private reply: added to the front of the title for the reply. See [[#PrivateReplyDisplay|Mockup: Private Reply Display]]
# The string Private reply will be translatable.

===== Mockups =====

====== Private Reply Display ======

[[Image:afPrivateReply.png|afPrivateReply.png]]

===== Use Cases =====

====== Student Views a Private Reply ======

'''Description'''

A student views a private reply from a student in a forum.

'''Preconditions'''

# The user is logged in
# The user is assigned to the student role in a course
# The student has created a reply in a forum
# A student has created a private reply to the student’s reply
# The user has navigated to a course with a private reply in it

'''Steps'''

# The student clicks on the forum
# The student scrolls to view the private reply

'''Postconditions'''

# The string Private reply shows in front of the title for the reply.

==== Accessible Discussion Display ====

===== Description =====

The current display options in advanced forums do not maximize the view for those with disabilities. The accessible discussion display will work to implement the prototype of an accessible forum by ESAI. Users will be able to switch between this discussion display and any other discussion display types.

===== Requirements =====

[test]

# A new discussion display mode will be added to the forum display drop down called accessible.
# The accessible forum display will be separated into 5 areas (See [[#AccessibleDisplayStructure|Mockup: Accessible Display Structure]])
## Moodle breadcrumb at the top
## Filter pane at the top
## Forum description (Only shown if set)
## Forum and Discussion selection pane on the left
## Discussion display pane on the right
# Forum management will still be maintained within Moodle’s navigation and settings blocks and accessed via the themes block display.
# The breadcrumb will initially display the full moodle path to the forum the user selected within the course. See [[#NoDiscussionSelected|Mockup: No Discussion Selected]]
# The user will be able to use skip navigation to jump to the forum/discussion pane. See [[#AccessibleDisplayStructure|Mockup: Accessible Display Structure]]
# Navigation from the Discussion display pane to the Forum and Discussion selection pane
# The access key 1 will be used to move to the focus to the Forum select box
# The access key 2 will be used to move the focus to the discussion selection tree view
# The F6 key will be used to to switch focus to the next pane of the filter, forum and discussion and the discussion display panes. See [[#AccessibleDisplayStructure|Mockup: Accessible Display Structure]]
# The Shift+F6 keys will be used to switch focus to the previous pane of the filter, forum and discussion and the discussion display panes. See [[#AccessibleDisplayStructure|Mockup: Accessible Display Structure]]
# When navigating between panes a screen reader will be informed of the region the user has navigated to.

====== Accessible Display Structure ======

[[Image:afAccessibleDisplayStructure.png|afAccessibleDisplayStructure.png]]

====== No Discussion Selected ======

[[Image:afNoDiscussionSelected.png|afNoDiscussionSelected.png]]

===== Use Cases =====

====== Student Selects Accessible Forum Display ======

'''Description'''

A student will a visual disability wants to maximize their usability of advanced forums and selects the accessible forum display type.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course with a maximum reply depth
# The student has navigated to the course
# The student is using a screen reader

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the screen reader to skip to the main content of the page
# The student tabs to the forum display select drop down
# The student uses the space button to open the the select drop down
# The student uses the arrow keys to highlight the accessible select option
# The student hits the enter key

'''Postconditions'''

# The page reloads
# The accessible forum display appears

====== Student Uses F6 to Navigate Between Panes ======

'''Description'''

A visually impaired user wants to quickly change between the panes in the accessible forum view using the F6 key.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student hits the F6 key

'''Postconditions'''

# The student is taken to the filter pane
# The student is informed they are in the filter region

====== Student Uses Shift+F6 to Navigate Between Panes ======

'''Description'''

A student wants to navigate back through the panes of the accessible forum display using the shift+F6 key combination.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student hits the Shift+F6 key combination

'''Postconditions'''

# The student is taken to the discussion display pane
# The student is informed they are in the discussion display region

====== Student Uses Access key 1 to Navigate to the Forum Selection box ======

'''Description'''

A student wants to jump directory to the forum selector to change the forum they are viewing.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student clicks the screen reader’s key combination for the access 1 key

'''Postconditions'''

# The keyboard focus is set of the forum selector box box

====== Student Uses Access key 2 to Navigate to the Discussion Selection Tree view ======

'''Description'''

A student wants to jump to the discussion tree selector to quickly select a new reply to listen to.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student clicks the screen reader’s key combination for the access 2 key

'''Postconditions'''

# The keyboard focus is set of the discussion selector tree view box

==== Accessible Forum Display Filter Pane ====

===== Description =====

In order to quickly access the information users need from the forums they will need to be able to sort and filter the discussions in the forum. Users will also need to be able to change the forum display to their preferred display from the default or current display.

===== Requirements =====

{note}See original [Specs 2.4 Advanced Forums] for how discussions are sorted using each sort by type{note}

# The filter pane will display the following menus based on the forum configuration for the teacher: (See [[#FilterPaneExpandedTeacher|Mockup: Filter Pane Expanded Teacher]])
## Group menu (only displayed if visible or separate groups is set for the forum)
### All participants
### List of all groups in the grouping assigned to the forum.
## Sort by (each menu item will have a sub menu for changing the sort to ascending or descending)
### Last post date
### Creation date
### Last name
### First name
### Number of replies
## Forum display
### Accessible
### Default
### Nested
### Tree
# The filter pane will display the following menus based on the forum configuration for the student: (See [[#FilterPaneExpandedStudent|Mockup: Filter Pane Expanded Student]])
## Sort by (each menu item will have a sub menu for changing the sort to ascending or descending)
### Last post date
### Creation date
### Last name
### First name
### Number of replies
## Forum display
### Accessible
### Default
### Nested
### Tree
# The filter pane will display the simple forum search form for all users. See [[#FilterPane|Mockup: Filter Pane]]
# The user will be able to tab to the first menu and the search field
# The user will use the left and right arrows to switch between menus and to open sub menus
# The user will use the up and down arrows to navigate between menu items
# The user will use the spacebar to open the menu
# Selecting a sort by option will open up the ascending or descending sub menu. See [[#FilterPaneExpandedStudent|Mockup: Filter Pane Expanded Student]]
# Selecting ascending or descending in a sort by submenu will rest the discussion display pane to its default state. See [[#NoDiscussionSelected|Mockup: No Discussion Selected]]
# Selecting ascending or descending in a sort by submenu will rest the page’s Moodle breadcrumb to the path to the current forum. See [[#NoDiscussionSelected|Mockup: No Discussion Selected]]
# Selecting ascending or descending will sort the discussion list based on the sort by and ascending or descending selection.
# Selecting ascending or descending will set the student’s focus to the Discussion tree view.
# If the forum is not set to use groups in the forum settings then the view group menu in the top navigation will not display. See [[#FilterPaneExpandedStudent|Mockup: Filter Pane Expanded Student]]
# Selecting a group in the view group selector will change the discussion pane to display only discussions for that group and all participants.
# Selecting a group in the view group selector will focus the user on the Discussion tree view
# Selecting a group will reset the discussion view pane to its default state of no discussion or reply being displayed. See [[#NoDiscussionSelected|Mockup: No Discussion Selected]]
# Selecting a group will reset the Moodle breadcrumb to the path to the current forum. See [[#NoDiscussionSelected|Mockup: No Discussion Selected]]
# Selecting a display type in the forum display menu will cause the page to reload and the new forum display to display the forum. See [[#NoDiscussionSelected|Mockup: No Discussion Selected]]
# Clicking the ''Search'' button will bring up the search results in the discussion display pane. See [[#SearchResults|Mockup: Search Results]]
# The search one the filter pane will search only the current forum.
# Clicking the ''Advanced search'' button will display the Advanced search modal. See [[#AdvancedSearchModal|Mockup: Advanced Search Modal]]
# The advanced search modal will lock the user’s keyboard in the modal until the user click the ''Close'', ''Cancel'', or ''Search forums'' button.
# Clicking the ''Search'' button on the filter pane or the ''Search forums'' button in the advanced search modal will display the search results in the discussion display pane. See [[#SearchResults|Mockup: Search Results]]
# The user’s browser focus will be placed on the discussion display pane after a search has finished.
# The search results will display the same as described in the [[#AccessibleForumDiscussionDisplayPane|Section: Accessible Forum Discussion Display Pane]] with a header titled Search results with a count of the number of posts found.
# The action menu for each post in the search results will consist of the following links: (See [[#SearchResults|Mockup: Search Results]])
## Show post in full discussion
## Show post and its replies
# Selecting Show post in full discussion in the action menu will cause the following to happen:
## The discussion display pane will display all posts in the discussion the post is in.
## The user’s browser focus will be placed on the post in the discussion display pane
# Selecting Show post and its replies in the action menu will cause the following to happen:
## The discussion display pane display the post and all replies to the post in the discussion hierarchy.
## The user’s browser focus will be placed on the post in the discussion display pane

===== Mockups =====

====== Filter Pane ======

[[Image:afFilterPane.png|afFilterPane.png]]

====== Filter Pane Expanded Teacher ======

[[Image:afFilterPaneExpandedTeacher.png|afFilterPaneExpandedTeacher.png]]

====== Filter Pane Expanded Student ======

[[Image:afFilterPaneExpandedStudent.png|afFilterPaneExpandedStudent.png]]

====== Search Results ======

[[Image:afSearchResults.png|afSearchResults.png]]

====== Advanced Search Modal ======

[[Image:afAdvancedSearchModal.png|afAdvancedSearchModal.png]]

===== Use Cases =====

====== Student Accesses the Sort by Menu Using a Keyboard ======

'''Description'''

A student accesses the sort by menu drop down using a screen reader and their keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the screen reader to jump to the main content
# The student uses the tab key to tab to the sort by menu

'''Postconditions'''

# Using the tab key the student is able to find the sort by menu
# The student is able to identify using the screen reader which menu they are on.

====== Student Accesses the Search Field Using a Keyboard ======

'''Description'''

A student accesses the search input field using a screen reader and their keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the screen reader to jump to the main content
# The student uses the tab key to tab to the search input field

'''Postconditions'''

# The student is able to identify that entering text in the field will search to forum for posts with that information in it.
# The student is able to identify they are in a form and need to tab to the ''Search forum'' button

====== Student Opens Sort By Menu Using a Keyboard ======

'''Description'''

A student opens the sort by menu using a screen reader and their keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the screen reader to jump to the main content
# The student uses the tab key to tab to the sort by menu
# The student uses the spacebar to open the sort by menu

'''Postconditions'''

# The sort by menu opens for the student
# The screen reader reads all of the sort by menu items.

====== Student Selects Sort By Number of Replies Descending Using a Keyboard ======

'''Description'''

A student selects sort by number or replies in a descending order using a screen reader and their keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display
# The advanced forum has more than 1 discussion and reply

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the screen reader to jump to the main content
# The student uses the tab key to tab to the sort by menu
# The student uses the spacebar to open the sort by menu
# The student uses the down arrow key to locate the ''Number of replies'' menu item
# The student uses the right arrow key to open the ''Number of replies'' sub menu
# The student uses the down arrow key to select the ''Descending'' menu item

'''Postconditions'''

# The discussion list is resorted by number of replies in a descending order
# The student’s browser focus is set to the discussion tree view
# The student is able to understand via the screen reader that they are not accessing the discussion tree view.

====== Student Navigates Between Menus Using a Keyboard ======

'''Description'''

A student accesses each menu using a keyboard and screen reader.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the screen reader to jump to the main content
# The student uses the tab key to tab to the sort by menu
# The student uses the left arrow key to navigate to the forum display menu

'''Postconditions'''

# The student is able to navigate to the forum display using the keyboard

====== Student Selects a Display Type Using a Keyboard ======

'''Description'''

A student changes the display type from accessible to default using a screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the screen reader to jump to the main content
# The student uses the tab key to tab to the sort by menu
# The student uses the left arrow key to navigate to the forum display menu
# The student uses the spacebar to open the forum display menu
# The student uses the down arrow key to select a new forum display type

'''Postconditions'''

# The student is able to navigate to the forum display using the keyboard
# The page is reloaded and the forum is displayed using the new forum display type

====== Teacher Selects a Group Using a Keyboard ======

'''Description'''

A teacher filters the lists of discussions by group using a screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a teacher
# An advanced forum has been created in the course
# The teacher has navigated to the course
# The teacher is using a screen reader
# The teacher has set the accessible forum display
# The advanced forum is setup to have separate groups
# Students are assigned to groups
# The forum has posts to each group as well as all participants.

'''Steps'''

# The teacher uses the screen reader to skip to the main content of the course
# The teacher tabs to the forum activity within the course
# The teacher hits the enter key
# The teacher uses the screen reader to jump to the main content
# The teacher uses the tab key to tab to the sort by menu
# The teacher uses the left arrow key to navigate to the view group menu
# The teacher uses the spacebar to open the view group menu
# The teacher uses the down arrow key to select a group to view

'''Postconditions'''

# The discussion tree view is updated with the discussions available to the selected group and all participants
# The teacher’s browser focus is set to the discussion tree view.

====== Student Searches the Forum Using a Keyboard ======

'''Description'''

A student uses a screen reader and keyboard to access the search input field in the filter pane and search the forum.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display
# There are discussion in the forum
# There are replies in the forum
# There are replies or discussions that match the search criteria in the forum.

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the F6 key to navigate to the filter pane
# The student tabs to the search input field
# The student enters their search text in the search input field
# The student tabs to the search button
# The student hits the enter key to search the forums

'''Postconditions'''

# The posts that are found matching the search criteria display in the discussion display pane
# The user’s browser focus is set to the discussion display pane.

====== Student Uses the Advanced Search to Search the Forum Using a Keyboard ======

'''Description'''

A student search the forum using the advanced search modal, a screen reader and a keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display
# There are discussion in the forum
# There are replies in the forum
# There are replies or discussions that match the search criteria in the forum.

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the F6 key to navigate to the filter pane
# The student tabs to the advanced search button
# The student hits the enter key
# The student uses the tab key to fill out the search criteria
# The student tabs to the search forum button
# The student hits enter to search the forum

'''Postconditions'''

# The posts that are found matching the search criteria display in the discussion display pane
# The user’s browser focus is set to the discussion display pane.

====== Student Displays the Discussion the Search Result is a Part of Using a Keyboard ======

'''Description'''

A student selects the to view the discussion that a search result post is a part of using a screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display
# There are discussion in the forum
# There are replies in the forum
# There are replies or discussions that match the search criteria in the forum.
# The user has finished searching via advanced search or simple search.

'''Steps'''

# The student uses the screen readers next header keyboard commands to locate the reply they want to edit.
# The student hits the tab key to tab to the action menu for the discussion
# The student uses the spacebar to open the action menu
# The student uses the down arrow to select the Show post in full discussion menu item
# The student uses the enter key to select the Show post in full discussion menu item

'''Postconditions'''

# The discussion pane displays the discussion that the post is in
# The user’s bowser focus is set to the post that Show post in full discussion was selected for.

====== Student Displays the Search Result and All Replies Using a Keyboard ======

'''Description'''

A student selects to display the search result post and all of its replies using a screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display
# There are discussion in the forum
# There are replies in the forum
# There are replies or discussions that match the search criteria in the forum.
# The user has finished searching via advanced search or simple search.

'''Steps'''

# The student uses the screen readers next header keyboard commands to locate the reply they want to edit.
# The student hits the tab key to tab to the action menu for the discussion
# The student uses the spacebar to open the action menu
# The student uses the down arrow to select the Show post and its replies menu item
# The student uses the enter key to select the Show post and its replies menu item

'''Postconditions'''

# The discussion pane displays the post and all of its sub replies
# The user’s bowser focus is set to the post that Show post and its replies was selected for.

==== Accessible Forum Display Forum and Discussion Pane ====

===== Description =====

The forum and discussion pane is designed to provide the user with quick access to overall activity within the forum. This is where the user quickly navigates to the discussion or reply they want to view in the discussion pane.

===== Requirements =====

# The Forum and discussion pane will display the following: (See [[#ForumandDiscussionPane|Mockup: Forum and Discussion Pane]])
## A drop down list of all forums in the course with the current forum selected
## A button to ''Add a new discussion topic''
## If visible or separate groups is set for the forum a statement of the setting will display below the forum select box. See [[#ForumandDiscussionPaneSeparateGroups|Mockup: Forum and Discussion Pane Separate Groups]] and [[#ForumandDiscussionPaneVisibleGroups|Mockup: Forum and Discussion Pane Visible Groups]]
## An expandable collapsable list of all discussions and replies in the currently selected forum the user can view.
# The forum selector drop down will not appear if there is only one forum in the course
# The forum selector will list all advanced forums in the course in alphabetical order
# Selecting a forum from the forum drop down will reload the page as if the user had clicked on the forum in the course.
# The ''Add a new discussion topic'' button will not appear for users if they do not have permissions to create a discussion.
# Clicking the ''Add a new discussion topic'' will display the ''Your new discussion topic'' forum in the discussion pane. See [[#NewDiscussionTopic|Mockup: New Discussion Topic]]
# Clicking the ''Post to forum'' button in the ''Your new discussion topic'' form causes the following to happen:
## Save the discussion to the forum
## Add the discussion title in the correct sort order to the discussion tree
## Display the new discussion in the discussion pane
## Place the browser focus on the new discussion.
# Clicking the ''Cancel'' button will cause the following to happen:
## Close the reset the discussion pane to the default state when no discussion is selected
## Return the user’s browser focus to the ''Add a new discussion topic'' button.
# The user will use tab to navigate between the forum selector, add a new discussion topic button and discussion tree.
# A group selector option will display below the mail now form field if a forum is set to separate or visible groups.
# The user will use the up and down arrows to navigate up and down in the discussion tree. See [[#ForumandDiscussionPaneExpanded|Mockup: Forum and Discussion Pane Expanded]]
# The user will use the left and right arrows to expand and contract the discussion tree. See [[#ForumandDiscussionPaneExpanded|Mockup: Forum and Discussion Pane Expanded]]
# The user will be able to use the mouse to click on the + and - images to expand and contract discussions and replies. See [[#ForumandDiscussionPaneExpanded|Mockup: Forum and Discussion Pane Expanded]]
# Discussions that are collapsed and have replies will have a + image to the left of the discussion title and the screen reader will read that the discussion is collapsed. See [[#ForumandDiscussionPaneExpanded|Mockup: Forum and Discussion Pane Expanded]]
# Replies that are collapsed and have replies will have a + image to the left of the reply title and the screen reader will read that the reply is collapsed. See [[#ForumandDiscussionPaneExpanded|Mockup: Forum and Discussion Pane Expanded]]
# Discussions that are expanded and have replies will have a - image to the left of the discussion title and the screen reader will read that the discussion is expanded. See [[#ForumandDiscussionPaneExpanded|Mockup: Forum and Discussion Pane Expanded]]
# Replies that are expanded and have replies will have a - image to the left of the reply title and the screen reader will read that the reply is expanded. See [[#ForumandDiscussionPaneExpanded|Mockup: Forum and Discussion Pane Expanded]]
# When expanded a discussion or reply will display all replies to the discussion in tree form below it. See [[#ForumandDiscussionPaneExpanded|Mockup: Forum and Discussion Pane Expanded]]
# If a discussion or reply has no replies to it then no image will display to the left of the title. See [[#ForumandDiscussionPaneExpanded|Mockup: Forum and Discussion Pane Expanded]]
# Users will use the enter key on a discussion to display the discussion and all replies in the discussion pane. See [[#DiscussionAccessibleDisplay|Mockup: Discussion Accessible Display]]
# Users will click on a discussion to display the discussion and all replies in the discussion pane. See [[#DiscussionAccessibleDisplay|Mockup: Discussion Accessible Display]]
# Users will use the enter key on a reply to display the reply and all replies to the reply in the discussion pane. See [[#SelectedReplyAccessibleDisplay|Mockup: Selected Reply Accessible Display]]
# Users will click on a reply to display the replies and all replies to the reply in the discussion pane. See [[#SelectedReplyAccessibleDisplay|Mockup: Selected Reply Accessible Display]]
# Clicking on a reply or discussion will place the user’s browser focus on the discussion pane
# Hitting the enter key on a discussion or reply link will place the user’s browser focus on the discussion pane.
# The discussion tree will display the number of unread replies for the discussion/reply to the right of the discussion/reply title if the user has read tracking enabled. See [[#ForumandDiscussionPane|Mockup: Forum and Discussion Pane]]
# Forums set to visible or separate groups will add the for and group name to the right of the discussion title when the post is set to a specific group in the discussion tree view. See [[#ForumandDiscussionPaneSeparateGroups|Mockup: Forum and Discussion Pane Separate Groups]] and [[#ForumandDiscussionPaneVisibleGroups|Mockup: Forum and Discussion Pane Visible Groups]]

===== Mockups =====

====== Forum and Discussion Pane ======

[[Image:afForumDiscussionPane.png|afForumDiscussionPane.png]]

====== Forum and Discussion Pane Expanded ======

[[Image:afForumDiscussionPaneExpanded.png|afForumDiscussionPaneExpanded.png]]

====== Forum and Discussion Pane Separate Groups ======

[[Image:afForumDiscussionPaneSeparateGroups.png|afForumDiscussionPaneSeparateGroups.png]]

====== Forum and Discussion Pane Visible Groups ======

[[Image:afForumDiscussionPaneVisibleGroups.png|afForumDiscussionPaneVisibleGroups.png]]

====== Discussion Accessible Display ======

[[Image:afAccessibleDiscussionDisplay.png|afAccessibleDiscussionDisplay.png]]

====== Selected Reply Accessible Display ======

[[Image:afAccessibleReplyDisplay.png|afAccessibleReplyDisplay.png]]

====== New Discussion Topic ======

[[Image:afNewTopicModal.png|afNewTopicModal.png]]

===== Use Cases =====

====== Student Uses a Keyboard to Navigate Between Forum and Discussion Panel Areas ======

'''Description'''

A student navigates between the forum selector, add a new discussion topic and the discussion tree using a screen reader and their keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the F6 key to get to the filter pane
# The student uses the F6 key to get to the forum and discussion pane
# The student uses the tab key to navigate between the areas of the forum and discussion pane

'''Postconditions'''

# The student is able to navigate between the forum selector and discussion tree areas
# The student with the use of the screen reader understands the areas they are navigating between.

====== Student Selects a Different Forum Using a Keyboard ======

'''Description'''

A student navigates to a different forum without going back to the course page using a screen reader and their keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display
# The is more than one forum in the course

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the F6 key to get to the filter pane
# The student uses the F6 key to get to the forum and discussion pane
# The student tabs to the forum selector
# The student uses the spacebar to open the forum selector
# The student uses the down arrow to select the next forum in the course
# The student hits the enter key to select the forum

'''Postconditions'''

# The page is reloaded and the student is in the accessible view of the selected forum.

====== Teacher Adds a New Discussion Topic Using a Keyboard ======

'''Description'''

A teacher with a visual disability adds a new discussion topic to the forum using their screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a teacher
# An advanced forum has been created in the course
# The teacher has navigated to the course
# The teacher is using a screen reader
# The teacher has set the accessible forum display

'''Steps'''

# The teacher uses the screen reader to skip to the main content of the course
# The teacher tabs to the forum activity within the course
# The teacher hits the enter key
# The teacher uses the F6 key to get to the filter pane
# The teacher uses the F6 key to get to the forum and discussion pane
# The teacher uses the tab key to navigate to the ''Add a new discussion topic'' button
# The teacher hit the enter key
# The teacher uses tab to fill in all field in the ''Your new discussion topic'' form
# The teacher tabs to the ''Post to forum'' button
# The teacher hits the enter key

'''Postconditions'''

# The teacher’s post is saved
# The teacher’s browser focus is placed on the discussion pane.
# The discussion tree is updated with the new discussion.

====== Teacher Adds a New Discussion Topic For a Specific Group Using a Keyboard ======

'''Description'''

A teacher with a visual disability adds a new discussion topic to the forum using their screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a teacher
# An advanced forum has been created in the course
# The teacher has navigated to the course
# The teacher is using a screen reader
# The teacher has set the accessible forum display
# The advanced forum is set to separate groups

'''Steps'''

# The teacher uses the screen reader to skip to the main content of the course
# The teacher tabs to the forum activity within the course
# The teacher hits the enter key
# The teacher uses the F6 key to get to the filter pane
# The teacher uses the F6 key to get to the forum and discussion pane
# The teacher uses the tab key to navigate to the ''Add a new discussion topic'' button
# The teacher hit the enter key
# The teacher uses tab to fill in all field in the ''Your new discussion topic'' form
# The teacher selects a specific group from the group selector
# The teacher tabs to the ''Post to forum'' button
# The teacher hits the enter key

'''Postconditions'''

# The teacher’s post is saved
# The teacher’s browser focus is placed back on discussion pane.
# The discussion tree is updated with the new discussion.
# The discussion title has the words for <group name selected> to its right.

====== Student Expands a Discussion Using a Keyboard ======

'''Description'''

A student expands a discussion to listen to all of the replies to the discussion using a screen reader and their keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display
# More than one discussion has been created
# Replies have been posted to discussions

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the F6 key to get to the filter pane
# The student uses the F6 key to get to the forum and discussion pane
# The student uses the tab key to navigate to the discussion tree
# The student uses the left arrow key to expand the replies to the discussion

'''Postconditions'''

# All the titles for the replies of reply depth 1 for the discussion are showing and read to the user via the screen reader

====== Student Expands a Discussion Using a Mouse ======

'''Description'''

A student expands the replies to a discussion using their mouse.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student has set the accessible forum display
# More than one discussion has been created
# Replies have been posted to discussions

'''Steps'''

# The student clicks on the forum in the course
# The student clicks on the plus image to the left of the discussion title

'''Postconditions'''

# All the titles for the replies of reply depth 1 for the discussion are displayed

====== Student Navigated Down the Discussion Tree Using a Keyboard ======

'''Description'''

A student navigates to a reply to a discussion using a screen reader and their keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display
# More than one discussion has been created
# Replies have been posted to discussions

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the F6 key to get to the filter pane
# The student uses the F6 key to get to the forum and discussion pane
# The student uses the tab key to navigate to the discussion tree
# The student uses the down arrow to navigate to the next discussion in the tree

'''Postconditions'''

# The title of the discussion is read to the student via the screen reader

====== Student Selects a Discussion to Display Using a Keyboard ======

'''Description'''

A student selects a discussion using a screen reader and their keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display
# More than one discussion has been created
# Replies have been posted to discussions

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the F6 key to get to the filter pane
# The student uses the F6 key to get to the forum and discussion pane
# The student uses the tab key to navigate to the discussion tree
# The student uses the down arrow to navigate to the next discussion
# The student hits the enter key

'''Postconditions'''

# The student’s browser focus is set to the discussion pane
# The discussion pane is updated to display the full discussion plus all replies in the discussion.

====== Student Selects a Discussion Using a Mouse ======

'''Description'''

A student selects a discussion using their mouse.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student has set the accessible forum display
# More than one discussion has been created
# Replies have been posted to discussions

'''Steps'''

# The student clicks on the forum in the course
# The student clicks on the discussion title

'''Postconditions'''

# The student’s browser focus is set to the discussion pane
# The discussion pane is updated to display the full discussion plus all replies in the discussion.

====== Student Locates a Discussion With Unread Replies using a Keyboard ======

'''Description'''

A student navigates through the discussion tree until they hear a discussion that has new replies to it. The student is using the screen reader and their keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display
# More than one discussion has been created
# Replies have been posted to discussions

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the F6 key to get to the filter pane
# The student uses the F6 key to get to the forum and discussion pane
# The student uses the down arrow to located a discussion with unread replies

'''Postconditions'''

# Each discussion title is read as the user uses the down arrow to navigate down
# The discussion title is read then the number of unread replies.

====== Student Selects a Reply Using a Keyboard ======

'''Description'''

A student navigates to a reply and selects it to listen to in the discussion pane using a screen reader and their keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display
# More than one discussion has been created
# Replies have been posted to discussions

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the F6 key to get to the filter pane
# The student uses the F6 key to get to the forum and discussion pane
# The student uses the right arrow to expand a discussion
# The student hits the enter key

'''Postconditions'''

# The student’s browser focus is set to the discussion pane
# The discussion pane is updated to display the reply and all replies of a reply depth below the starting reply.

====== Student Selects a Reply Using a Mouse ======

'''Description'''

A student navigates to a reply and selects it to listen to in the discussion pane using their mouse.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student has set the accessible forum display
# More than one discussion has been created
# Replies have been posted to discussions

'''Steps'''

# The student clicks on the forum in the course
# The student clicks on the plus image to the left of the discussion title
# The student clicks on the reply title

'''Postconditions'''

# The student’s browser focus is set to the discussion pane
# The discussion pane is updated to display the reply and all replies of a reply depth below the starting reply.

==== Accessible Forum Discussion Display Pane ====

===== Description =====

The discussion display pane is the region of the forum that displays to the user the specific discussion or reply they have chosen with all sub replies. The pane is designed to present the selected discussion or reply in the most accessible manner focusing on simplified content and easy tabbing between actions. HTML headers are used to help inform the user where they are in the hierarchy of the discussion.

{note}It is understood that using HTML header’s to denote the hierarchy of the forum has the issue that HTML only has a header level up to H6. Furthermore H1 is only used once on a page and for the page heading. This is why the maximum reply depth setting has been added. It also should be noted that after a reply depth of 3 forum replies become less focused on the original discussion topic.{note}

===== Requirements =====

# The discussion pane will be separated into 2 areas: (See [[#DiscussionDisplayPaneStructure|Mockup: Discussion Display Pane Structure]])
## Message display area. This is a live area that is updated with message as information is added or removed.
## Discussion/reply display area. This is dynamically updated based on content changes and the forum and discussion pane.
# Messages in the message area will display for 30 seconds and then be removed from the page.
# The message output area will not be accessible by keyboard if there are no messages displayed within the area.
# Each discussion or reply will be separated into 3 areas: (See [[#Discussion/ReplyStructure|Mockup: Discussion/Reply Structure]])
## Heading
## Post
### Post text
### File attachments
## Actions
# A discussion/reply heading will display the following information in this order: (See [[#TeacherViewsOwnDiscussion|Mockup: Teacher Views Own Discussion]])
## Post title using the correct HTML header based on reply depth (see below)
## Author with their image and name, the image will not be identified to a screen reader (alt=“”)
## Post date, the date the post was created
## Rating type and value (this will only display if ratings are enabled for the forum)
# The accessible display mode will use HTML header tags (h2-h6) for the title of the discussion post and replies. See [[#DiscussionAccessibleDisplay|Mockup: Discussion Accessible Display]]
# The discussion post will use a h2 HTML header tag for the title of the post. See [[#DiscussionAccessibleDisplay|Mockup: Discussion Accessible Display]]
# A replies reply depth will determine the HTML header tag to be used for the title: (See [[#DiscussionAccessibleDisplay|Mockup: Discussion Accessible Display]])
## Reply depth 1 will use the HTML header h3
## Reply depth 2 will use the HTML header h4
## Reply depth 3 will use the HTML header h5
## Reply depth 4 will use the HTML header h6
# Forums that allow a reply depth greater then 4 will use the HTML Header tag of H6 for all reply titles at a depth of 4 or greater.
# The post text area will display the post text and then any file attachments in an unordered list below the post text. See [[#Discussion/ReplyStructure|Mockup: Discussion/Reply Structure]]
# If there are no actions the user can perform on the post then the action area and menu will not display
# When the forum is set to separate groups and a discussion is set to all participants the action area and action menu will not display to students.
# Replies in the discussion pane will display based on the reply hierarchy and depth.
# If the teacher is the creator of the discussion or reply their name will be denoted in bold and the screen reader will read “Teacher” before reading the poster’s name.
# Anywhere in the below action menus if the action is subscribe it will be replaced with unsubscribe if the user is already subscribed to the discussion.
# Anywhere in the below action menus if the action bookmark is available the option remove bookmark will show if the discussion or reply is already bookmarked
# Anywhere in the below action menus if the action mark substantive is available the option Unmark substantive will show if the discussion or reply is already marked as substantive.
# Reply will display in the below action menus only if the user has permissions to create a reply
# Rating and view ratings will only display in the action menus if the rating setting is enabled for the forum.
# A teacher will have the following actions available when viewing their own discussion: (See [[#TeacherViewsOwnDiscussion|Mockup: Teacher Views Own Discussion]])
## Edit
## Delete
## View ratings (only displays if ratings are enabled for the forum)
## Subscribe (will not display if subscribed to the forum or forum subscription is disabled)
## Mark substantive
## Bookmark
## Reply
# A teacher will have the following actions available when viewing their own reply: (See [[#TeacherViewsTeacherReply|Mockup: Teacher Views Teacher Reply]])
## Edit
## Split
## Delete
## View ratings (only displays if ratings are enabled for the forum)
## Mark substantive
## Bookmark
## Reply
# A teacher will have the following actions available when viewing a student’s reply: (See [[#TeacherViewsStudentReply|Mockup: Teacher Views Student Reply]])
## Reply
## Split
## Delete
## Rate (only displays if ratings are enabled for the forum)
## Mark substantive
## Bookmark
# A student will have the following actions available when viewing a discussion: (See [[#StudentViewsDiscussion|Mockup: Student Views Discussion]])
## Reply
## Rate
## Subscribe
# A student will have the following actions available when viewing their own reply: (See [[#StudentViewsOwnReply|Mockup: Student Views Own Reply]])
## Edit
## Delete
## Reply
# A private reply will display only to the student who created the original reply and the teachers.
# A teacher will have the following options available when viewing a private reply: (See [[#TeacherViewPrivateReply|Mockup: Teacher View Private Reply]])
## Edit
## Split
## Delete
# The action area and menu will not display to a student for a private reply.
# The user’s picture will display as the default user picture for an anonymous forum. See ([[#AnonymousReply|Mockup: Anonymous Reply]])
# The user’s name will appear as a Anonymous user instead of the creators real name.
# A user will have all the same action menu menu items for an anonymous reply as they would for a reply of the same type in a regular forum.
# A user will be able to use the spacebar to open the action menu
# A user will be able to use the tab key to navigate to a post’s action menu
# A user will be able to use the enter key to select an action menu item.
# Selecting the reply action will bring up the reply form below the post the user is replying to.
# The student reply modal will have the fields in [[#StudentReplyFormInline|Mockup: Student Reply Form Inline]]
# The file upload area will not display if the forum is set to not allow attachments.
# The teacher reply form will have the following additional form fields compared to a student’s reply form based on the type of forum and the forum settings: See ([[#TeacherReplyFormInline|Mockup: Teacher Reply Form Inline]])
## Mail now
## Group (select box with available groups if the forum is set to visible or separate groups)
## Private reply
## Reveal yourself in this post (if the forum is set to anonymous)
# Clicking the ''Post to forum'' button in the reply form will cause the following things to happen:
## The reply is added as the last reply to the post the user selected reply for
## The discussion tree view is updated to reflect the added reply if the parent post is expanded
## The user’s browser focus is placed on the header of the newly created reply.
# Clicking the ''Cancel'' button in the reply form will cause the following things to happen:
## The reply form stops displaying inline below the current post
## The user’s browser focus is placed on the header of the post the user was replying to.
# Selecting the split action will bring up the split post modal. See ([[#SplitPostModal|Mockup: Split Post Modal]])
# The split post modal will key the keyboard locked in the modal until the user clicks the ''Close'', ''Cancel'', or ''Split'' button.
# Clicking the ''Split'' button in the split modal will cause the following things to happen:
## The Split post modal to close
## The post converted to the initial discussion post for the new discussion with the title in the new discussion title field of the modal
## The reply hierarchy for the post are still associated with the post
## The discussion display pane will display the new discussion that the post was split into.
## The user’s browser focus is placed on the header for the initial post of the new discussion
## The discussion tree in the forum and discussion pane is updated to reflect the changes to the forum hierarchy
# Selecting the delete action will bring up a conformation that the user wants to delete the reply or discussion. See ([[#DeleteReplyModal|Mockup: Delete Reply Modal]])
# Clicking the ''Delete post'' button in the delete post modal will do the following things:
## Close the modal
## Remove the post and the reply in the hierarchy attached to the post and lower.
## Add a message to the message output stating “The <post header> was successfully deleted”.
## The user’s browser focus will be placed on the success message.
# The delete post modal will keep the keyboard locked in the modal until the user clicks the ''Close'', ''Cancel'', or ''Delete post'' button.
# Selecting the edit action will bring up the reply form inline pre-populated with the post that is being edited. See ([[#EditReplyForumInline|Mockup: Edit Reply Form Inline]])
# Selecting the rate action will bring up the rate modal pre-populated with the current rating the user has given the post. See [[#RatingModal|Mockup: Rating Modal]]
# The rate post modal will key the keyboard locked in the modal until the user clicks the ''Close'', ''Cancel'', or ''Rate post'' button.
# Clicking the ''Rate'' button in the rate modal will cause the following things to happen:
## The rate post modal will close
## The rating the user had entered will be saved for the post
## The rating for the post will update based on the forum settings.
## A message will be added the message output area stating “The rating was successfully saved” with a link to jump back to the post within the discussion display panel.
# Selecting the view ratings action will bring up the view ratings modal. See ([[#ViewRatingsModal|Mockup: View Ratings Modal]])
# The view ratings modal will keep the user’s keyboard focus until the user clicking on the ''Close'' or ''Close this window'' button.
# Closing a modal using the ''Close'', ''Close this window'' or ''Cancel'' buttons will place the user’s browser focus back on the action menu the user was on when they opened the modal.
# Any errors in the processing of a modal will display an error message in the message output area with a link back to the area the user was in when the error occurred.
# Selecting the ''Subscribe'' action will do the following things:
## Subscribe the user to the discussion to receive emails when new replies are created in the discussion
## Display a message in the message output stating that the user has been subscribed to the discussion
## Place the user’s browser focus on the message output.
# Selecting the ''Unsubscribe'' action will do the following things:
## Unsubscribe the user from the discussion and cause the user to stop receiving emails when new replies are created in the discussion
## Display a message in the message output stating that the user has been unsubscribed to the discussion
## Place the user’s browser focus on the message output.
# Selecting the ''Bookmark'' action will do the following things:
## Add the bookmark flag to the post
## Display a message in the message output stating that the post was bookmarked
## The message will end with a link to jump to the post that was bookmarked.
## Place the user’s browser focus on the message output
# Selecting the ''Remove bookmark'' action will do the following things:
## Remove the bookmark flag from the post
## Display a message in the message output stating that the bookmark has been removed from the post
## The message will end with a link to jump to the post that the bookmark was removed from.
## Place the user’s browser focus on the message output
## The message will end with a link to jump to the post that the bookmark was removed from.
# Selecting the ''Mark substantive'' action will do the following things:
## Add the substantive flag to the post
## Display a message in the message output stating that the post was flagged as substantive
## The message will end with a link to jump to the post that was flagged as substantive
## Place the user’s browser focus on the message output
# Selecting the ''Unmark substantive'' mark_ action will do the following things:
## Remove the substantive flag from the post
## Display a message in the message output stating that the substantive flag was removed from the post
## The message will end with a link to jump to the post the substantive flag was removed from.
## Place the user’s browser focus on the message output

===== Mockups =====

====== Discussion Display Pane Structure ======

[[Image:afDiscussionDisplayPaneStructure.png|afDiscussionDisplayPaneStructure.png]]

====== Discussion/Reply Structure ======

[[Image:afReplyStructure.png|afReplyStructure.png]]

====== Teacher Views Own Discussion ======

[[Image:afTeacherViewOwnDiscussion.png|afTeacherViewOwnDiscussion.png]]

====== Teacher Views Teacher Reply ======

[[Image:afTeacherViewTeacherReply.png|afTeacherViewTeacherReply.png]]

====== Teacher Views Student Reply ======

[[Image:afTeacherViewStudentReply.png|afTeacherViewStudentReply.png]]

====== Student Views Discussion ======

[[Image:afStudentViewDiscussion.png|afStudentViewDiscussion.png]]

====== Student Views Own Reply ======

[[Image:afStudentViewOwnReply.png|afStudentViewOwnReply.png]]

====== Teacher View Private Reply ======

[[Image:afPrivateReply.png|afPrivateReply.png]]

====== Anonymous Reply ======

[[Image:afAnonymousReply.png|afAnonymousReply.png]]

====== Student Reply Form Inline ======

[[Image:afStudentReplyModal.png|afStudentReplyModal.png]]

====== Teacher Reply Form Inline ======

[[Image:afTeacherReplyModal.png|afTeacherReplyModal.png]]

====== Rating Modal ======

[[Image:afRatingModal.png|afRatingModal.png]]

====== Split Post Modal ======

[[Image:afSplitModal.png|afSplitModal.png]]

====== Delete Post Modal ======

[[Image:afDeletePostModal.png|afDeletePostModal.png]]

====== Edit Reply Form Inline ======

[[Image:afEditModal.png|afEditModal.png]]

====== View Ratings Modal ======

[[Image:afViewRatingsModal.png|afViewRatingsModal.png]]

===== Use Cases =====

====== Student Listens to a Discussion Created by a Teacher ======

'''Description'''

A student selects a discussion using a screen reader and keyboard and listens to the screen reader read the discussion post.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the forum
# The student is using a screen reader
# The student has set the accessible forum display
# More than one discussion has been created by the teacher
# Replies have been posted to discussions

'''Steps'''

# The student uses the F6 key to get to the filter pane
# The student uses the F6 key to get to the forum and discussion pane
# The student uses the enter key to select the discussion

'''Postconditions'''

# The student is able to identify that the teacher created the discussion and not just another student.

====== Student Navigates Between Replies to a Discussion Using a Keyboard ======

'''Description'''

A student navigates between reply headings using the screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the forum
# The student is using a screen reader
# The student has set the accessible forum display
# More than one discussion has been created by the teacher
# The student has made a reply to a discussion

'''Steps'''

# The student uses the F6 key to get to the filter pane
# The student uses the F6 key to get to the forum and discussion pane
# The student uses the enter key to select the discussion
# The student uses the screen readers next header function to locate the next reply

'''Postconditions'''

# The student can identify by the header where they are within the forum hierarchy.
# The student is able to quickly navigate to each reply

====== Student Replies to a Discussion Using a Keyboard ======

'''Description'''

A student creates a reply to a discussion using a screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the forum
# The student is using a screen reader
# The student has set the accessible forum display
# More than one discussion has been created by the teacher
# Replies have been posted to discussions

'''Steps'''

# The student uses the F6 key to get to the filter pane
# The student uses the F6 key to get to the forum and discussion pane
# The student uses the enter key to select the discussion
# The student hits the tab key to tab to the action menu for the discussion
# The student hits the spacebar to open the action menu
# The student uses the down arrow to navigate to the reply action
# The student hits the enter key
# The student uses the tab key to tab through the forum fields and enter a reply
# The student tabs to the ''Post to forum'' button
# The student hits the enter key

'''Postconditions'''

# The reply is added to the discussion display pane in the proper place
# The student hears the header of the new reply

====== Student Edits a Reply Using a Keyboard ======

'''Description'''

A student edits a reply they have made using a screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the forum
# The student is using a screen reader
# The student has set the accessible forum display
# More than one discussion has been created by the teacher
# The student has made a reply to a discussion

'''Steps'''

# The student uses the F6 key to get to the filter pane
# The student uses the F6 key to get to the forum and discussion pane
# The student uses the enter key to select the discussion
# The student uses the screen readers next header keyboard commands to locate the reply they want to edit.
# The student hits the tab key to tab to the action menu for the discussion
# The student uses the spacebar to open the action menu
# The student uses the down arrow to select the edit menu item
# The student uses the enter key to select the edit menu item
# The student uses the tab key to navigate to the field they want to change
# The student uses the tab key to navigate to the ''Post to forum'' button
# The student hits the enter key to post the edits to the forum

'''Postconditions'''

# The reply is updated in the discussion display pane in the proper place
# The student hears the header of the edited reply

====== Student Subscribes to a Discussion Using a Keyboard ======

'''Description'''

A student subscribes to a discussion using a screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the forum
# The student is using a screen reader
# The student has set the accessible forum display
# More than one discussion has been created by the teacher
# The forum is set to optional forum subscriptions.
# The student is not subscribed to the forum
# The student has not subscribed to the discussion

'''Steps'''

# The student uses the F6 key to get to the filter pane
# The student uses the F6 key to get to the forum and discussion pane
# The student uses the enter key to select the discussion
# The student uses the screen readers next header keyboard commands to locate the reply they want to subscribe to.
# The student hits the tab key to tab to the action menu for the discussion
# The student uses the spacebar to open the action menu
# The student uses the down arrow to select the subscribe menu item
# The student uses the enter key to select the subscribe menu item

'''Postconditions'''

# The student is subscribed to the discussion
# A message is displayed in the message output area stating that the student has been subscribed to the discussion.
# The student hears the message

====== Student Accesses a Discussion’s Action Menu Using a Mouse ======

'''Description'''

A student displays a discussion’s action menu using a mouse.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the forum
# The student is using a screen reader
# The student has set the accessible forum display
# More than one discussion has been created by the teacher

'''Steps'''

# The student clicks on the discussion
# The student clicks on the action menu for the discussion

'''Postconditions'''

# The action menu expands

====== Teacher Rates a Post Using a Keyboard ======

'''Description'''

A teacher rates a student’s post using a screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a teacher
# An advanced forum has been created in the course
# The teacher has navigated to the course
# The teacher is using a screen reader
# The teacher has set the accessible forum display
# The teacher has created a discussion
# A student has made a reply to a discussion
# The forum is set to allow rating
# The student reply has not been rated

'''Steps'''

# The teacher uses the F6 key to get to the filter pane
# The teacher uses the F6 key to get to the forum and discussion pane
# The teacher uses the enter key to select the discussion
# The teacher uses the screen readers next header keyboard commands to locate the reply they want to rate.
# The teacher hits the tab key to tab to the action menu for the discussion
# The teacher uses the spacebar to open the action menu
# The teacher uses the down arrow to select the rate menu item
# The teacher uses the enter key to select the rate menu item
# The teacher uses the spacebar to open the rating select box
# The teacher uses the down arrow to select the rating they want.
# The teacher hits the enter key to select the rating for the post
# The teacher uses the tab key to navigate to the rate button.
# The teacher uses the enter key to rate the post.

'''Postconditions'''

# The post is rated
# The post’s rating is recalculated
# A message is displayed in the message output area stating that the post has been rated and allowing the teacher to jump to the post they rated.
# The student hears the message

====== Teacher Deletes a Discussion Using a Keyboard ======

'''Description'''

A teacher deletes a discussion using a screen reader and keyboard

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a teacher
# An advanced forum has been created in the course
# The teacher has navigated to the course
# The teacher is using a screen reader
# The teacher has set the accessible forum display
# A discussion has been created in the forum
# A reply has been made to the discussion

'''Steps'''

# The teacher uses the F6 key to get to the filter pane
# The teacher uses the F6 key to get to the forum and discussion pane
# The teacher uses the enter key to select the discussion
# The teacher hits the tab key to tab to the action menu for the discussion
# The teacher uses the spacebar to open the action menu
# The teacher uses the down arrow to select the delete menu item
# The teacher uses the enter key to select the delete menu item
# The teacher uses the spacebar to open the delete select box
# The teacher listens to the modal window text
# The teacher uses the tab key to navigate to the delete post button.
# The teacher uses the enter key to delete post button to delete the post.

'''Postconditions'''

# The post is deleted
# A message is displayed in the message output area stating that the post has been deleted and allowing the teacher to jump back to the forum and discussion pane
# The student hears the message

====== Teacher the Views Ratings for a Post Using a Keyboard ======

'''Description'''

A teacher views the ratings that have been given for a student’s post using a screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a teacher
# An advanced forum has been created in the course
# The teacher has navigated to the course
# The teacher is using a screen reader
# The teacher has set the accessible forum display
# The teacher has created a discussion
# A student has made a reply to a discussion
# The teacher and others have rated a student’s reply

'''Steps'''

# The teacher uses the F6 key to get to the filter pane
# The teacher uses the F6 key to get to the forum and discussion pane
# The teacher uses the enter key to select the discussion
# The teacher uses the screen readers next header keyboard commands to locate the reply they want to view the ratings for.
# The teacher hits the tab key to tab to the action menu for the discussion
# The teacher uses the spacebar to open the action menu
# The teacher uses the down arrow to select the view ratings menu item
# The teacher uses the enter key to select the view ratings menu item

'''Postconditions'''

# The view ratings modal appears with all the ratings that have been submitted for the post.

====== Teacher Splits a Reply Using a Keyboard ======

'''Description'''

A teacher splits a reply into a new discussion using a screen reader and keyboard

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a teacher
# An advanced forum has been created in the course
# The teacher has navigated to the course
# The teacher is using a screen reader
# The teacher has set the accessible forum display
# The teacher has created a discussion
# The reply has multiple replies to it.

'''Steps'''

# The teacher uses the F6 key to get to the filter pane
# The teacher uses the F6 key to get to the forum and discussion pane
# The teacher uses the enter key to select the discussion
# The teacher uses the screen readers next header keyboard commands to locate the reply they want to split.
# The teacher hits the tab key to tab to the action menu for the discussion
# The teacher uses the spacebar to open the action menu
# The teacher uses the down arrow to select the split menu item
# The teacher uses the enter key to select the split menu item
# The teacher uses the tab key to tab to the new discussion title field and enters a discussion title
# The teacher tabs to the split button
# The teacher hits the enter key to split the reply

'''Postconditions'''

# A new discussion is created from the reply with the title provided in the new discussion title field
# A message appears in the message output area that states the reply was split.
# The teacher’s browser focus is set to the message output
# The discussion display pane shows the newly created discussion
# The discussion tree in the forum and discussion pane is updated with the new discussion.

====== Teacher Marks a Post as Substantive Using a Keyboard ======

'''Description'''

A teacher marks a post as substantive using a screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a teacher
# An advanced forum has been created in the course
# The teacher has navigated to the course
# The teacher is using a screen reader
# The teacher has set the accessible forum display
# The teacher has created a discussion
# A student has made a reply to a discussion

'''Steps'''

# The teacher uses the F6 key to get to the filter pane
# The teacher uses the F6 key to get to the forum and discussion pane
# The teacher uses the enter key to select the discussion
# The teacher uses the screen readers next header keyboard commands to locate the reply they want mark as substantive.
# The teacher hits the tab key to tab to the action menu for the discussion
# The teacher uses the spacebar to open the action menu
# The teacher uses the down arrow to select the mark substantive menu item
# The teacher uses the enter key to select the mark substantive menu item

'''Postconditions'''

# The post is marked as substantive
# A message is added to the message output area stating that the post has been marked substantive and a link is included to allow the teacher to jump to the post.
# The teacher’s browser focus is placed on the message output.
# The teacher hears the message read to them.

====== Teacher Bookmarks a Post Using a Keyboard ======

'''Description'''

A teacher bookmarks a post using a screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a teacher
# An advanced forum has been created in the course
# The teacher has navigated to the course
# The teacher is using a screen reader
# The teacher has set the accessible forum display
# The teacher has created a discussion
# A student has made a reply to a discussion

'''Steps'''

# The teacher uses the F6 key to get to the filter pane
# The teacher uses the F6 key to get to the forum and discussion pane
# The teacher uses the enter key to select the discussion
# The teacher uses the screen readers next header keyboard commands to locate the reply they want to view the ratings for.
# The teacher hits the tab key to tab to the action menu for the discussion
# The teacher uses the spacebar to open the action menu
# The teacher uses the down arrow to select the bookmark menu item
# The teacher uses the enter key to select the bookmark menu item

'''Postconditions'''

# The post is flagged as bookmarked
# A message is added to the message output area stating that the post has been bookmarked and a link is included to allow the teacher to jump to the post.
# The teacher’s browser focus is placed on the message output.
# The teacher hears the message read to them.

=== Glossary ===

* {anchor:replydepth} '''Reply depth:''' The hierarchical level that a reply is on. A reply to a discussion is reply depth 1. A reply to a reply is depth 2. A reply to a reply to a reply is depth 3. Example: Discussion (depth 0) Reply (depth 1) Reply 2 (depth 2) Replay 3 (depth 3) Reply 4 (depth 2) Replay 5 (depth 1)

=== Document Change Management ===

==== Revision Summary ====

# Switched from a reply modal to an inline reply form to allow the user to navigate back up in the discussion hierarchy to listen to the post they are replying to.

==== Revision History ====

# Jason Hardin 20130812: Updated the specification to remove the reply modals and replace the references with inline forms. Updated some language to make the requirements make more sense.

=== Open Questions ===

# Is the breadcrumb required in Moodle for the forum?
# Does the breadcrumb need to be dynamically updated based on the user’s selection in the discussion tree?

==See also==
[[Category: Project]]

Advanced Forums Accessible Display Specification

2013-08-12T20:30:48Z

Psychoph:

=== Visioning ===

==== Overview ====

The Moodle forums is not as accessible as it could be. In order to improve usability of forums for those with disabilities Moodlerooms is will enhance advanced forums to display discussions based on EASI: Equal Access to Software & Information’s accessible forum design.

==== Business Goals ====

# Progress towards NFB Certification
# Keep strategic clients
# Improve sales for prospects with high accessibility requirements.

==== Product Goals ====

# Increase the accessibility of forum discussion display
# Increase usability of forums

==== Business References ====

* University of Montana (UofM)
* National Federation of the Blind (NFB)
* Department of Education
* [[http://easi.cc/|ASI: EQUAL ACCESS TO SOFTWARE & INFORMATION]]
* [[http://webaim.org/|WebAIM]]
* [[http://collaborate.athenpro.org/group/moodle/|Moodle Accessibility Group]]

=== Scenarios ===

==== Administrator Sets Advanced Forums as the Forums for All Forums on a Site ====

The administrator needs to force all forums to be created as advanced forums to meet the institutions accessibility policy. To do this the administrator sets all news forums to be created as advanced forums and disabled each roles capabilities to create forums.

==== Teacher Restricts Number of Replies ====

In order to keep forum conversations on topic the student wants to keep the depth of replies to a minimal. After a number of replies to replies a user will not be able to create a reply to a reply.

==== A Visually Impaired Student Listens to Posts in a Course Forum ====

A student needs to review the new posts that students and students have posted to their course forums. Using a screen reader the student accesses the forum and listens to the replies that have been made in the forum.

==== A Visually Impaired Student Replies to a Post in a Course Forum ====

A student wants to reply to a discussion made by the student. Using a screen reader the student navigates to the discussion and hits return when they find the reply link. The student is then placed in a text editor to create their reply. The student then saves the reply by navigating to the post button.

==== A Visually Impaired Student Sorts Forum Discussions ====

A student wants to sort the discussions by which have the newest posts in order to understand what the latest changes are to the forum. The student navigates to the sort using a screen reader and hits enter when they have found the sort by newest post.

=== References ===

==== Jira ====

==== Technical ====

* [[http://easi.cc/archive/bb2013/recording/index.htm|Recording of a discussion on the accessible prototype (EASI)]]
* [[https://dl.dropboxusercontent.com/u/137779786/discussion_module_mockup/discussion_board-listview.html|Prototype of an accessible forum (ESAI) ]]
* [[http://www.oaa-accessibility.org/examples/|OpenAjax Accessibility examples]]
* [[http://webaim.org/techniques/keyboard/accesskey|WebAIM on keyboard shortcuts]]
* [Specs 2.4 Advanced Forums]

=== Feature Information ===

==== Advanced Forums Site Settings ====

===== Description =====

Advanced forums will allow administrators to set the default forum display (renamed from discussion display) for all users. Advanced forums will also allow a site administrator to set the default maximum reply depth.

===== Requirements =====

# Rename Discussion display to Forum display in advanced forums display types.
# A new checkbox administrative settings called Create news forums as advanced forums will be added to the activity’s administrative settings page. See [[#AdvancedForumAdministrativeSettings|Mockup: Advanced Forum Administrative Settings]]
# The default value for the Create news forums as advanced forums is unchecked aka no.
# A new select box administrative settings called Default forum display will be added to the activity’s administrative settings page. See [[#AdvancedForumAdministrativeSettings|Mockup: Advanced Forum Administrative Settings]]
# The default value for the Default forum display is default
# The possible values for the Default forum display will be:
## Accessible
## Default
## Nested
## Tree
# A new administrative settings called Maximum reply depth will be added to the activity’s administrative settings page. See [[#AdvancedForumAdministrativeSettings|Mockup: Advanced Forum Administrative Settings]]
# The default value for the Maximum reply depth will be 3. See [[#AdvancedForumAdministrativeSettings|Mockup: Advanced Forum Administrative Settings]]

===== Mockups =====

====== Advanced Forum Administrative Settings ======

[[Image:afAdminSettings.png|afAdminSettings.png]]

===== Use Cases =====

====== Administrator Sets Default Forum Display ======

'''Description'''

The administrator sets the default forum display to accessible.

'''Preconditions'''

# The user is logged in
# The user is assigned as a site administrator
# The user is at the site level

'''Steps'''

# The administrator clicks on the ''Plugins'' link group under the Settings block
# The administrator clicks on the ''Activity modules'' link group
# The administrator clicks on the ''Advanced forums'' link
# The administrator selects ''Accessible'' from the ''Default forum display'' select box
# The administrator clicks the ''Save changes'' button

'''Postconditions'''

# the settings are saved

====== Administrator Sets the Site to Create all News Forums as Advanced Forums ======

'''Description'''

The administrator sets the site to use advanced forums for all newly created news forums.

'''Preconditions'''

# The user is logged in
# The user is assigned as a site administrator
# The user is at the site level

'''Steps'''

# The administrator clicks on the ''Plugins'' link group under the Settings block
# The administrator clicks on the ''Activity modules'' link group
# The administrator clicks on the ''Advanced forums'' link
# The administrator clicks the checkbox to the left of Create all new forums as advanced forums
# The administrator clicks the ''Save changes'' button

'''Postconditions'''

# The settings are saved

====== Administrator Sets the Default Maximum Reply Depth ======

'''Description'''

The administrator sets the default maximum reply depth for all newly created forums to be 1.

'''Preconditions'''

# The user is logged in
# The user is assigned as a site administrator
# The user is at the site level

'''Steps'''

# The administrator clicks on the ''Plugins'' link group under the Settings block
# The administrator clicks on the ''Activity modules'' link group
# The administrator clicks on the ''Advanced forums'' link
# The administrator enters 1 in the text box to the right of the Maximum reply depth setting.
# The administrator clicks the ''Save changes'' button

'''Postconditions'''

# The settings are saved.

====== Administrator Creates a Course With an Advanced Forums News Forum ======

'''Description'''

The administrator creates a course with a news forum. The news forum is created as an advanced forum.

'''Preconditions'''

# The user is logged in
# The user is assigned as a site administrator
# The advanced forum setting create news forums as advanced forums is checked.
# The user is at the site level

'''Steps'''

# The administrator clicks the ''Courses'' link group
# The administrator clicks the ''Add/edit courses'' link
# The administrator clicks the ''Add a new course'' button
# The administrator fills out the course information
# The administrator clicks the ''Save changes'' button

'''Postconditions'''

# The news forum created for the course is an advanced forum.

==== Advanced Forum Accessible Settings ====

===== Description =====

A new setting will be added to the create a forum screen that will allow the student to restrict the maximum depth of replies for a discussion.

===== Requirements =====

# A new setting will be added to the create a forum screen under the general group called maximum [[#replydepth|reply depth]]. See [[#AdvancedForumDepthSetting|Mockup: Advanced Forum Depth Setting]]
# The default value for the maximum [[#replydepth|reply depth]] will be 3
# The maximum [[#replydepth|reply depth]] will be 7
# Once the [[#replydepth|reply depth]] in a discussion reaches maximum reply depth the a student will not be able to reply to the reply. See [[#MaximumReplyDepthDisplay|Mockup: Maximum Reply Depth Display]]
# When a teacher creates a reply to the maximum depth reply the reply will be marked automatically as a private reply.
# A teacher will be unable to uncheck the private reply checkbox for a reply to a reply at the maximum reply depth. See [[#TeacherReplytoaMaximumDepthReply|Mockup: Teacher Reply to a Maximum Depth Reply]]

===== Mockups =====

====== Advanced Forum Depth Setting ======

[[Image:afMaxDepthSetting.png|afMaxDepthSetting.png]]

====== Maximum Reply Depth Display ======

[[Image:afMaxReplyDepthDisplay.png|afMaxReplyDepthDisplay.png]]

====== Teacher Reply to a Maximum Depth Reply ======

[[Image:afMaxReplyPrivateReply.png|afMaxReplyPrivateReply.png]]

===== Use Cases =====

====== Teacher Creates a Forum with a Maximum Reply Depth of 2 ======

'''Description'''

The student wants to limit the reply depth to 2 to keep the students on track with the forum discussion.

'''Preconditions'''

# The user is logged in
# The users is assigned the student role in the course
# The user has navigated to the course
# The course is set to weeks or topics format

'''Steps'''

# The student clicks on the add activity link
# The student selects Advanced forum
# The student fills out the forum information
# The student selects one from the select box for maximum reply depth

'''Postconditions'''

# Users cannot reply to a reply or a reply
# The student can still create a private reply to a reply of a reply

====== A Student Views a Reply at the Maximum Reply Depth ======

'''Description'''

A student views a reply that is at the maximum reply depth.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course with a maximum reply depth
# The forum has multiple replies with one at the maximum reply depth
# The student has navigated to the course

'''Steps'''

# The student clicks on the forum
# The student scrolls to the reply at the maximum reply depth

'''Postconditions'''

# The student doesn’t see the reply link.

====== A Teacher Replies to a Maximum Reply Depth Reply ======

'''Description'''

The student wants to create a private reply to the student’s reply even though it is at the maximum reply depth.

'''Preconditions'''

# The user is logged in
# The user is assigned to the student role in a course
# An advanced forum has been created in the course with a maximum reply depth
# The forum has multiple replies with one at the maximum reply depth
# The student has navigated to the course

'''Steps'''

# The student clicks on the forum
# The student scrolls to the reply at the maximum reply depth
# The student clicks on the reply link
# The student fills out the reply form
# The student clicks the ''Post to forum'' button

'''Postconditions'''

# The Private reply checkbox is checked and disabled
# The student can’t change the reply to a non private reply.

==== Private Reply Display ====

===== Description =====

To improve the accessibility of private replies Moodlerooms will add a string to the front of private replies to identify them to the user.

===== Requirements =====

# Private replies will have the string Private reply: added to the front of the title for the reply. See [[#PrivateReplyDisplay|Mockup: Private Reply Display]]
# The string Private reply will be translatable.

===== Mockups =====

====== Private Reply Display ======

[[Image:afPrivateReply.png|afPrivateReply.png]]

===== Use Cases =====

====== Student Views a Private Reply ======

'''Description'''

A student views a private reply from a student in a forum.

'''Preconditions'''

# The user is logged in
# The user is assigned to the student role in a course
# The student has created a reply in a forum
# A student has created a private reply to the student’s reply
# The user has navigated to a course with a private reply in it

'''Steps'''

# The student clicks on the forum
# The student scrolls to view the private reply

'''Postconditions'''

# The string Private reply shows in front of the title for the reply.

==== Accessible Discussion Display ====

===== Description =====

The current display options in advanced forums do not maximize the view for those with disabilities. The accessible discussion display will work to implement the prototype of an accessible forum by ESAI. Users will be able to switch between this discussion display and any other discussion display types.

===== Requirements =====

[test]

# A new discussion display mode will be added to the forum display drop down called accessible.
# The accessible forum display will be separated into 5 areas (See [[#AccessibleDisplayStructure|Mockup: Accessible Display Structure]])
## Moodle breadcrumb at the top
## Filter pane at the top
## Forum description (Only shown if set)
## Forum and Discussion selection pane on the left
## Discussion display pane on the right
# Forum management will still be maintained within Moodle’s navigation and settings blocks and accessed via the themes block display.
# The breadcrumb will initially display the full moodle path to the forum the user selected within the course. See [[#NoDiscussionSelected|Mockup: No Discussion Selected]]
# The user will be able to use skip navigation to jump to the forum/discussion pane. See [[#AccessibleDisplayStructure|Mockup: Accessible Display Structure]]
# Navigation from the Discussion display pane to the Forum and Discussion selection pane
# The access key 1 will be used to move to the focus to the Forum select box
# The access key 2 will be used to move the focus to the discussion selection tree view
# The F6 key will be used to to switch focus to the next pane of the filter, forum and discussion and the discussion display panes. See [[#AccessibleDisplayStructure|Mockup: Accessible Display Structure]]
# The Shift+F6 keys will be used to switch focus to the previous pane of the filter, forum and discussion and the discussion display panes. See [[#AccessibleDisplayStructure|Mockup: Accessible Display Structure]]
# When navigating between panes a screen reader will be informed of the region the user has navigated to.

====== Accessible Display Structure ======

[[Image:afAccessibleDisplayStructure.png|afAccessibleDisplayStructure.png]]

====== No Discussion Selected ======

[[Image:afNoDiscussionSelected.png|afNoDiscussionSelected.png]]

===== Use Cases =====

====== Student Selects Accessible Forum Display ======

'''Description'''

A student will a visual disability wants to maximize their usability of advanced forums and selects the accessible forum display type.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course with a maximum reply depth
# The student has navigated to the course
# The student is using a screen reader

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the screen reader to skip to the main content of the page
# The student tabs to the forum display select drop down
# The student uses the space button to open the the select drop down
# The student uses the arrow keys to highlight the accessible select option
# The student hits the enter key

'''Postconditions'''

# The page reloads
# The accessible forum display appears

====== Student Uses F6 to Navigate Between Panes ======

'''Description'''

A visually impaired user wants to quickly change between the panes in the accessible forum view using the F6 key.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student hits the F6 key

'''Postconditions'''

# The student is taken to the filter pane
# The student is informed they are in the filter region

====== Student Uses Shift+F6 to Navigate Between Panes ======

'''Description'''

A student wants to navigate back through the panes of the accessible forum display using the shift+F6 key combination.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student hits the Shift+F6 key combination

'''Postconditions'''

# The student is taken to the discussion display pane
# The student is informed they are in the discussion display region

====== Student Uses Access key 1 to Navigate to the Forum Selection box ======

'''Description'''

A student wants to jump directory to the forum selector to change the forum they are viewing.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student clicks the screen reader’s key combination for the access 1 key

'''Postconditions'''

# The keyboard focus is set of the forum selector box box

====== Student Uses Access key 2 to Navigate to the Discussion Selection Tree view ======

'''Description'''

A student wants to jump to the discussion tree selector to quickly select a new reply to listen to.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student clicks the screen reader’s key combination for the access 2 key

'''Postconditions'''

# The keyboard focus is set of the discussion selector tree view box

==== Accessible Forum Display Filter Pane ====

===== Description =====

In order to quickly access the information users need from the forums they will need to be able to sort and filter the discussions in the forum. Users will also need to be able to change the forum display to their preferred display from the default or current display.

===== Requirements =====

{note}See original [Specs 2.4 Advanced Forums] for how discussions are sorted using each sort by type{note}

# The filter pane will display the following menus based on the forum configuration for the teacher: (See [[#FilterPaneExpandedTeacher|Mockup: Filter Pane Expanded Teacher]])
## Group menu (only displayed if visible or separate groups is set for the forum)
### All participants
### List of all groups in the grouping assigned to the forum.
## Sort by (each menu item will have a sub menu for changing the sort to ascending or descending)
### Last post date
### Creation date
### Last name
### First name
### Number of replies
## Forum display
### Accessible
### Default
### Nested
### Tree
# The filter pane will display the following menus based on the forum configuration for the student: (See [[#FilterPaneExpandedStudent|Mockup: Filter Pane Expanded Student]])
## Sort by (each menu item will have a sub menu for changing the sort to ascending or descending)
### Last post date
### Creation date
### Last name
### First name
### Number of replies
## Forum display
### Accessible
### Default
### Nested
### Tree
# The filter pane will display the simple forum search form for all users. See [[#FilterPane|Mockup: Filter Pane]]
# The user will be able to tab to the first menu and the search field
# The user will use the left and right arrows to switch between menus and to open sub menus
# The user will use the up and down arrows to navigate between menu items
# The user will use the spacebar to open the menu
# Selecting a sort by option will open up the ascending or descending sub menu. See [[#FilterPaneExpandedStudent|Mockup: Filter Pane Expanded Student]]
# Selecting ascending or descending in a sort by submenu will rest the discussion display pane to its default state. See [[#NoDiscussionSelected|Mockup: No Discussion Selected]]
# Selecting ascending or descending in a sort by submenu will rest the page’s Moodle breadcrumb to the path to the current forum. See [[#NoDiscussionSelected|Mockup: No Discussion Selected]]
# Selecting ascending or descending will sort the discussion list based on the sort by and ascending or descending selection.
# Selecting ascending or descending will set the student’s focus to the Discussion tree view.
# If the forum is not set to use groups in the forum settings then the view group menu in the top navigation will not display. See [[#FilterPaneExpandedStudent|Mockup: Filter Pane Expanded Student]]
# Selecting a group in the view group selector will change the discussion pane to display only discussions for that group and all participants.
# Selecting a group in the view group selector will focus the user on the Discussion tree view
# Selecting a group will reset the discussion view pane to its default state of no discussion or reply being displayed. See [[#NoDiscussionSelected|Mockup: No Discussion Selected]]
# Selecting a group will reset the Moodle breadcrumb to the path to the current forum. See [[#NoDiscussionSelected|Mockup: No Discussion Selected]]
# Selecting a display type in the forum display menu will cause the page to reload and the new forum display to display the forum. See [[#NoDiscussionSelected|Mockup: No Discussion Selected]]
# Clicking the ''Search'' button will bring up the search results in the discussion display pane. See [[#SearchResults|Mockup: Search Results]]
# The search one the filter pane will search only the current forum.
# Clicking the ''Advanced search'' button will display the Advanced search modal. See [[#AdvancedSearchModal|Mockup: Advanced Search Modal]]
# The advanced search modal will lock the user’s keyboard in the modal until the user click the ''Close'', ''Cancel'', or ''Search forums'' button.
# Clicking the ''Search'' button on the filter pane or the ''Search forums'' button in the advanced search modal will display the search results in the discussion display pane. See [[#SearchResults|Mockup: Search Results]]
# The user’s browser focus will be placed on the discussion display pane after a search has finished.
# The search results will display the same as described in the [[#AccessibleForumDiscussionDisplayPane|Section: Accessible Forum Discussion Display Pane]] with a header titled Search results with a count of the number of posts found.
# The action menu for each post in the search results will consist of the following links: (See [[#SearchResults|Mockup: Search Results]])
## Show post in full discussion
## Show post and its replies
# Selecting Show post in full discussion in the action menu will cause the following to happen:
## The discussion display pane will display all posts in the discussion the post is in.
## The user’s browser focus will be placed on the post in the discussion display pane
# Selecting Show post and its replies in the action menu will cause the following to happen:
## The discussion display pane display the post and all replies to the post in the discussion hierarchy.
## The user’s browser focus will be placed on the post in the discussion display pane

===== Mockups =====

====== Filter Pane ======

[[Image:afFilterPane.png|afFilterPane.png]]

====== Filter Pane Expanded Teacher ======

[[Image:afFilterPaneExpandedTeacher.png|afFilterPaneExpandedTeacher.png]]

====== Filter Pane Expanded Student ======

[[Image:afFilterPaneExpandedStudent.png|afFilterPaneExpandedStudent.png]]

====== Search Results ======

[[Image:afSearchResults.png|afSearchResults.png]]

====== Advanced Search Modal ======

[[Image:afAdvancedSearchModal.png|afAdvancedSearchModal.png]]

===== Use Cases =====

====== Student Accesses the Sort by Menu Using a Keyboard ======

'''Description'''

A student accesses the sort by menu drop down using a screen reader and their keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the screen reader to jump to the main content
# The student uses the tab key to tab to the sort by menu

'''Postconditions'''

# Using the tab key the student is able to find the sort by menu
# The student is able to identify using the screen reader which menu they are on.

====== Student Accesses the Search Field Using a Keyboard ======

'''Description'''

A student accesses the search input field using a screen reader and their keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the screen reader to jump to the main content
# The student uses the tab key to tab to the search input field

'''Postconditions'''

# The student is able to identify that entering text in the field will search to forum for posts with that information in it.
# The student is able to identify they are in a form and need to tab to the ''Search forum'' button

====== Student Opens Sort By Menu Using a Keyboard ======

'''Description'''

A student opens the sort by menu using a screen reader and their keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the screen reader to jump to the main content
# The student uses the tab key to tab to the sort by menu
# The student uses the spacebar to open the sort by menu

'''Postconditions'''

# The sort by menu opens for the student
# The screen reader reads all of the sort by menu items.

====== Student Selects Sort By Number of Replies Descending Using a Keyboard ======

'''Description'''

A student selects sort by number or replies in a descending order using a screen reader and their keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display
# The advanced forum has more than 1 discussion and reply

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the screen reader to jump to the main content
# The student uses the tab key to tab to the sort by menu
# The student uses the spacebar to open the sort by menu
# The student uses the down arrow key to locate the ''Number of replies'' menu item
# The student uses the right arrow key to open the ''Number of replies'' sub menu
# The student uses the down arrow key to select the ''Descending'' menu item

'''Postconditions'''

# The discussion list is resorted by number of replies in a descending order
# The student’s browser focus is set to the discussion tree view
# The student is able to understand via the screen reader that they are not accessing the discussion tree view.

====== Student Navigates Between Menus Using a Keyboard ======

'''Description'''

A student accesses each menu using a keyboard and screen reader.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the screen reader to jump to the main content
# The student uses the tab key to tab to the sort by menu
# The student uses the left arrow key to navigate to the forum display menu

'''Postconditions'''

# The student is able to navigate to the forum display using the keyboard

====== Student Selects a Display Type Using a Keyboard ======

'''Description'''

A student changes the display type from accessible to default using a screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the screen reader to jump to the main content
# The student uses the tab key to tab to the sort by menu
# The student uses the left arrow key to navigate to the forum display menu
# The student uses the spacebar to open the forum display menu
# The student uses the down arrow key to select a new forum display type

'''Postconditions'''

# The student is able to navigate to the forum display using the keyboard
# The page is reloaded and the forum is displayed using the new forum display type

====== Teacher Selects a Group Using a Keyboard ======

'''Description'''

A student filters the lists of discussions by group using a screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display
# The advanced forum is setup to have separate groups
# Students are assigned to groups
# The forum has posts to each group as well as all participants.

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the screen reader to jump to the main content
# The student uses the tab key to tab to the sort by menu
# The student uses the left arrow key to navigate to the view group menu
# The student uses the spacebar to open the view group menu
# The student uses the down arrow key to select a group to view

'''Postconditions'''

# The discussion tree view is updated with the discussions available to the selected group and all participants
# The student’s browser focus is set to the discussion tree view.

====== Student Searches the Forum Using a Keyboard ======

'''Description'''

A student uses a screen reader and keyboard to access the search input field in the filter pane and search the forum.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display
# There are discussion in the forum
# There are replies in the forum
# There are replies or discussions that match the search criteria in the forum.

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the F6 key to navigate to the filter pane
# The student tabs to the search input field
# The student enters their search text in the search input field
# The student tabs to the search button
# The student hits the enter key to search the forums

'''Postconditions'''

# The posts that are found matching the search criteria display in the discussion display pane
# The user’s browser focus is set to the discussion display pane.

====== Student Uses the Advanced Search to Search the Forum Using a Keyboard ======

'''Description'''

A student search the forum using the advanced search modal, a screen reader and a keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display
# There are discussion in the forum
# There are replies in the forum
# There are replies or discussions that match the search criteria in the forum.

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the F6 key to navigate to the filter pane
# The student tabs to the advanced search button
# The student hits the enter key
# The student uses the tab key to fill out the search criteria
# The student tabs to the search forum button
# The student hits enter to search the forum

'''Postconditions'''

# The posts that are found matching the search criteria display in the discussion display pane
# The user’s browser focus is set to the discussion display pane.

====== Student Displays the Discussion the Search Result is a Part of Using a Keyboard ======

'''Description'''

A student selects the to view the discussion that a search result post is a part of using a screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display
# There are discussion in the forum
# There are replies in the forum
# There are replies or discussions that match the search criteria in the forum.
# The user has finished searching via advanced search or simple search.

'''Steps'''

# The student uses the screen readers next header keyboard commands to locate the reply they want to edit.
# The student hits the tab key to tab to the action menu for the discussion
# The student uses the spacebar to open the action menu
# The student uses the down arrow to select the Show post in full discussion menu item
# The student uses the enter key to select the Show post in full discussion menu item

'''Postconditions'''

# The discussion pane displays the discussion that the post is in
# The user’s bowser focus is set to the post that Show post in full discussion was selected for.

====== Student Displays the Search Result and All Replies Using a Keyboard ======

'''Description'''

A student selects to display the search result post and all of its replies using a screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display
# There are discussion in the forum
# There are replies in the forum
# There are replies or discussions that match the search criteria in the forum.
# The user has finished searching via advanced search or simple search.

'''Steps'''

# The student uses the screen readers next header keyboard commands to locate the reply they want to edit.
# The student hits the tab key to tab to the action menu for the discussion
# The student uses the spacebar to open the action menu
# The student uses the down arrow to select the Show post and its replies menu item
# The student uses the enter key to select the Show post and its replies menu item

'''Postconditions'''

# The discussion pane displays the post and all of its sub replies
# The user’s bowser focus is set to the post that Show post and its replies was selected for.

==== Accessible Forum Display Forum and Discussion Pane ====

===== Description =====

The forum and discussion pane is designed to provide the user with quick access to overall activity within the forum. This is where the user quickly navigates to the discussion or reply they want to view in the discussion pane.

===== Requirements =====

# The Forum and discussion pane will display the following: (See [[#ForumandDiscussionPane|Mockup: Forum and Discussion Pane]])
## A drop down list of all forums in the course with the current forum selected
## A button to ''Add a new discussion topic''
## If visible or separate groups is set for the forum a statement of the setting will display below the forum select box. See [[#ForumandDiscussionPaneSeparateGroups|Mockup: Forum and Discussion Pane Separate Groups]] and [[#ForumandDiscussionPaneVisibleGroups|Mockup: Forum and Discussion Pane Visible Groups]]
## An expandable collapsable list of all discussions and replies in the currently selected forum the user can view.
# The forum selector drop down will not appear if there is only one forum in the course
# The forum selector will list all advanced forums in the course in alphabetical order
# Selecting a forum from the forum drop down will reload the page as if the user had clicked on the forum in the course.
# The ''Add a new discussion topic'' button will not appear for users if they do not have permissions to create a discussion.
# Clicking the ''Add a new discussion topic'' will display the ''Your new discussion topic'' forum in the discussion pane. See [[#NewDiscussionTopic|Mockup: New Discussion Topic]]
# Clicking the ''Post to forum'' button in the ''Your new discussion topic'' form causes the following to happen:
## Save the discussion to the forum
## Add the discussion title in the correct sort order to the discussion tree
## Display the new discussion in the discussion pane
## Place the browser focus on the new discussion.
# Clicking the ''Cancel'' button will cause the following to happen:
## Close the reset the discussion pane to the default state when no discussion is selected
## Return the user’s browser focus to the ''Add a new discussion topic'' button.
# The user will use tab to navigate between the forum selector, add a new discussion topic button and discussion tree.
# A group selector option will display below the mail now form field if a forum is set to separate or visible groups.
# The user will use the up and down arrows to navigate up and down in the discussion tree. See [[#ForumandDiscussionPaneExpanded|Mockup: Forum and Discussion Pane Expanded]]
# The user will use the left and right arrows to expand and contract the discussion tree. See [[#ForumandDiscussionPaneExpanded|Mockup: Forum and Discussion Pane Expanded]]
# The user will be able to use the mouse to click on the + and - images to expand and contract discussions and replies. See [[#ForumandDiscussionPaneExpanded|Mockup: Forum and Discussion Pane Expanded]]
# Discussions that are collapsed and have replies will have a + image to the left of the discussion title and the screen reader will read that the discussion is collapsed. See [[#ForumandDiscussionPaneExpanded|Mockup: Forum and Discussion Pane Expanded]]
# Replies that are collapsed and have replies will have a + image to the left of the reply title and the screen reader will read that the reply is collapsed. See [[#ForumandDiscussionPaneExpanded|Mockup: Forum and Discussion Pane Expanded]]
# Discussions that are expanded and have replies will have a - image to the left of the discussion title and the screen reader will read that the discussion is expanded. See [[#ForumandDiscussionPaneExpanded|Mockup: Forum and Discussion Pane Expanded]]
# Replies that are expanded and have replies will have a - image to the left of the reply title and the screen reader will read that the reply is expanded. See [[#ForumandDiscussionPaneExpanded|Mockup: Forum and Discussion Pane Expanded]]
# When expanded a discussion or reply will display all replies to the discussion in tree form below it. See [[#ForumandDiscussionPaneExpanded|Mockup: Forum and Discussion Pane Expanded]]
# If a discussion or reply has no replies to it then no image will display to the left of the title. See [[#ForumandDiscussionPaneExpanded|Mockup: Forum and Discussion Pane Expanded]]
# Users will use the enter key on a discussion to display the discussion and all replies in the discussion pane. See [[#DiscussionAccessibleDisplay|Mockup: Discussion Accessible Display]]
# Users will click on a discussion to display the discussion and all replies in the discussion pane. See [[#DiscussionAccessibleDisplay|Mockup: Discussion Accessible Display]]
# Users will use the enter key on a reply to display the reply and all replies to the reply in the discussion pane. See [[#SelectedReplyAccessibleDisplay|Mockup: Selected Reply Accessible Display]]
# Users will click on a reply to display the replies and all replies to the reply in the discussion pane. See [[#SelectedReplyAccessibleDisplay|Mockup: Selected Reply Accessible Display]]
# Clicking on a reply or discussion will place the user’s browser focus on the discussion pane
# Hitting the enter key on a discussion or reply link will place the user’s browser focus on the discussion pane.
# The discussion tree will display the number of unread replies for the discussion/reply to the right of the discussion/reply title if the user has read tracking enabled. See [[#ForumandDiscussionPane|Mockup: Forum and Discussion Pane]]
# Forums set to visible or separate groups will add the for and group name to the right of the discussion title when the post is set to a specific group in the discussion tree view. See [[#ForumandDiscussionPaneSeparateGroups|Mockup: Forum and Discussion Pane Separate Groups]] and [[#ForumandDiscussionPaneVisibleGroups|Mockup: Forum and Discussion Pane Visible Groups]]

===== Mockups =====

====== Forum and Discussion Pane ======

[[Image:afForumDiscussionPane.png|afForumDiscussionPane.png]]

====== Forum and Discussion Pane Expanded ======

[[Image:afForumDiscussionPaneExpanded.png|afForumDiscussionPaneExpanded.png]]

====== Forum and Discussion Pane Separate Groups ======

[[Image:afForumDiscussionPaneSeparateGroups.png|afForumDiscussionPaneSeparateGroups.png]]

====== Forum and Discussion Pane Visible Groups ======

[[Image:afForumDiscussionPaneVisibleGroups.png|afForumDiscussionPaneVisibleGroups.png]]

====== Discussion Accessible Display ======

[[Image:afAccessibleDiscussionDisplay.png|afAccessibleDiscussionDisplay.png]]

====== Selected Reply Accessible Display ======

[[Image:afAccessibleReplyDisplay.png|afAccessibleReplyDisplay.png]]

====== New Discussion Topic ======

[[Image:afNewTopicModal.png|afNewTopicModal.png]]

===== Use Cases =====

====== Student Uses a Keyboard to Navigate Between Forum and Discussion Panel Areas ======

'''Description'''

A student navigates between the forum selector, add a new discussion topic and the discussion tree using a screen reader and their keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the F6 key to get to the filter pane
# The student uses the F6 key to get to the forum and discussion pane
# The student uses the tab key to navigate between the areas of the forum and discussion pane

'''Postconditions'''

# The student is able to navigate between the forum selector and discussion tree areas
# The student with the use of the screen reader understands the areas they are navigating between.

====== Student Selects a Different Forum Using a Keyboard ======

'''Description'''

A student navigates to a different forum without going back to the course page using a screen reader and their keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display
# The is more than one forum in the course

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the F6 key to get to the filter pane
# The student uses the F6 key to get to the forum and discussion pane
# The student tabs to the forum selector
# The student uses the spacebar to open the forum selector
# The student uses the down arrow to select the next forum in the course
# The student hits the enter key to select the forum

'''Postconditions'''

# The page is reloaded and the student is in the accessible view of the selected forum.

====== Teacher Adds a New Discussion Topic Using a Keyboard ======

'''Description'''

A teacher with a visual disability adds a new discussion topic to the forum using their screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a teacher
# An advanced forum has been created in the course
# The teacher has navigated to the course
# The teacher is using a screen reader
# The teacher has set the accessible forum display

'''Steps'''

# The teacher uses the screen reader to skip to the main content of the course
# The teacher tabs to the forum activity within the course
# The teacher hits the enter key
# The teacher uses the F6 key to get to the filter pane
# The teacher uses the F6 key to get to the forum and discussion pane
# The teacher uses the tab key to navigate to the ''Add a new discussion topic'' button
# The teacher hit the enter key
# The teacher uses tab to fill in all field in the ''Your new discussion topic'' form
# The teacher tabs to the ''Post to forum'' button
# The teacher hits the enter key

'''Postconditions'''

# The teacher’s post is saved
# The teacher’s browser focus is placed on the discussion pane.
# The discussion tree is updated with the new discussion.

====== Teacher Adds a New Discussion Topic For a Specific Group Using a Keyboard ======

'''Description'''

A teacher with a visual disability adds a new discussion topic to the forum using their screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a teacher
# An advanced forum has been created in the course
# The teacher has navigated to the course
# The teacher is using a screen reader
# The teacher has set the accessible forum display
# The advanced forum is set to separate groups

'''Steps'''

# The teacher uses the screen reader to skip to the main content of the course
# The teacher tabs to the forum activity within the course
# The teacher hits the enter key
# The teacher uses the F6 key to get to the filter pane
# The teacher uses the F6 key to get to the forum and discussion pane
# The teacher uses the tab key to navigate to the ''Add a new discussion topic'' button
# The teacher hit the enter key
# The teacher uses tab to fill in all field in the ''Your new discussion topic'' form
# The teacher selects a specific group from the group selector
# The teacher tabs to the ''Post to forum'' button
# The teacher hits the enter key

'''Postconditions'''

# The teacher’s post is saved
# The teacher’s browser focus is placed back on discussion pane.
# The discussion tree is updated with the new discussion.
# The discussion title has the words for <group name selected> to its right.

====== Student Expands a Discussion Using a Keyboard ======

'''Description'''

A student expands a discussion to listen to all of the replies to the discussion using a screen reader and their keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display
# More than one discussion has been created
# Replies have been posted to discussions

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the F6 key to get to the filter pane
# The student uses the F6 key to get to the forum and discussion pane
# The student uses the tab key to navigate to the discussion tree
# The student uses the left arrow key to expand the replies to the discussion

'''Postconditions'''

# All the titles for the replies of reply depth 1 for the discussion are showing and read to the user via the screen reader

====== Student Expands a Discussion Using a Mouse ======

'''Description'''

A student expands the replies to a discussion using their mouse.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student has set the accessible forum display
# More than one discussion has been created
# Replies have been posted to discussions

'''Steps'''

# The student clicks on the forum in the course
# The student clicks on the plus image to the left of the discussion title

'''Postconditions'''

# All the titles for the replies of reply depth 1 for the discussion are displayed

====== Student Navigated Down the Discussion Tree Using a Keyboard ======

'''Description'''

A student navigates to a reply to a discussion using a screen reader and their keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display
# More than one discussion has been created
# Replies have been posted to discussions

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the F6 key to get to the filter pane
# The student uses the F6 key to get to the forum and discussion pane
# The student uses the tab key to navigate to the discussion tree
# The student uses the down arrow to navigate to the next discussion in the tree

'''Postconditions'''

# The title of the discussion is read to the student via the screen reader

====== Student Selects a Discussion to Display Using a Keyboard ======

'''Description'''

A student selects a discussion using a screen reader and their keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display
# More than one discussion has been created
# Replies have been posted to discussions

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the F6 key to get to the filter pane
# The student uses the F6 key to get to the forum and discussion pane
# The student uses the tab key to navigate to the discussion tree
# The student uses the down arrow to navigate to the next discussion
# The student hits the enter key

'''Postconditions'''

# The student’s browser focus is set to the discussion pane
# The discussion pane is updated to display the full discussion plus all replies in the discussion.

====== Student Selects a Discussion Using a Mouse ======

'''Description'''

A student selects a discussion using their mouse.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student has set the accessible forum display
# More than one discussion has been created
# Replies have been posted to discussions

'''Steps'''

# The student clicks on the forum in the course
# The student clicks on the discussion title

'''Postconditions'''

# The student’s browser focus is set to the discussion pane
# The discussion pane is updated to display the full discussion plus all replies in the discussion.

====== Student Locates a Discussion With Unread Replies using a Keyboard ======

'''Description'''

A student navigates through the discussion tree until they hear a discussion that has new replies to it. The student is using the screen reader and their keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display
# More than one discussion has been created
# Replies have been posted to discussions

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the F6 key to get to the filter pane
# The student uses the F6 key to get to the forum and discussion pane
# The student uses the down arrow to located a discussion with unread replies

'''Postconditions'''

# Each discussion title is read as the user uses the down arrow to navigate down
# The discussion title is read then the number of unread replies.

====== Student Selects a Reply Using a Keyboard ======

'''Description'''

A student navigates to a reply and selects it to listen to in the discussion pane using a screen reader and their keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display
# More than one discussion has been created
# Replies have been posted to discussions

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the F6 key to get to the filter pane
# The student uses the F6 key to get to the forum and discussion pane
# The student uses the right arrow to expand a discussion
# The student hits the enter key

'''Postconditions'''

# The student’s browser focus is set to the discussion pane
# The discussion pane is updated to display the reply and all replies of a reply depth below the starting reply.

====== Student Selects a Reply Using a Mouse ======

'''Description'''

A student navigates to a reply and selects it to listen to in the discussion pane using their mouse.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student has set the accessible forum display
# More than one discussion has been created
# Replies have been posted to discussions

'''Steps'''

# The student clicks on the forum in the course
# The student clicks on the plus image to the left of the discussion title
# The student clicks on the reply title

'''Postconditions'''

# The student’s browser focus is set to the discussion pane
# The discussion pane is updated to display the reply and all replies of a reply depth below the starting reply.

==== Accessible Forum Discussion Display Pane ====

===== Description =====

The discussion display pane is the region of the forum that displays to the user the specific discussion or reply they have chosen with all sub replies. The pane is designed to present the selected discussion or reply in the most accessible manner focusing on simplified content and easy tabbing between actions. HTML headers are used to help inform the user where they are in the hierarchy of the discussion.

{note}It is understood that using HTML header’s to denote the hierarchy of the forum has the issue that HTML only has a header level up to H6. Furthermore H1 is only used once on a page and for the page heading. This is why the maximum reply depth setting has been added. It also should be noted that after a reply depth of 3 forum replies become less focused on the original discussion topic.{note}

===== Requirements =====

# The discussion pane will be separated into 2 areas: (See [[#DiscussionDisplayPaneStructure|Mockup: Discussion Display Pane Structure]])
## Message display area. This is a live area that is updated with message as information is added or removed.
## Discussion/reply display area. This is dynamically updated based on content changes and the forum and discussion pane.
# Messages in the message area will display for 30 seconds and then be removed from the page.
# The message output area will not be accessible by keyboard if there are no messages displayed within the area.
# Each discussion or reply will be separated into 3 areas: (See [[#Discussion/ReplyStructure|Mockup: Discussion/Reply Structure]])
## Heading
## Post
### Post text
### File attachments
## Actions
# A discussion/reply heading will display the following information in this order: (See [[#TeacherViewsOwnDiscussion|Mockup: Teacher Views Own Discussion]])
## Post title using the correct HTML header based on reply depth (see below)
## Author with their image and name, the image will not be identified to a screen reader (alt=“”)
## Post date, the date the post was created
## Rating type and value (this will only display if ratings are enabled for the forum)
# The accessible display mode will use HTML header tags (h2-h6) for the title of the discussion post and replies. See [[#DiscussionAccessibleDisplay|Mockup: Discussion Accessible Display]]
# The discussion post will use a h2 HTML header tag for the title of the post. See [[#DiscussionAccessibleDisplay|Mockup: Discussion Accessible Display]]
# A replies reply depth will determine the HTML header tag to be used for the title: (See [[#DiscussionAccessibleDisplay|Mockup: Discussion Accessible Display]])
## Reply depth 1 will use the HTML header h3
## Reply depth 2 will use the HTML header h4
## Reply depth 3 will use the HTML header h5
## Reply depth 4 will use the HTML header h6
# Forums that allow a reply depth greater then 4 will use the HTML Header tag of H6 for all reply titles at a depth of 4 or greater.
# The post text area will display the post text and then any file attachments in an unordered list below the post text. See [[#Discussion/ReplyStructure|Mockup: Discussion/Reply Structure]]
# If there are no actions the user can perform on the post then the action area and menu will not display
# When the forum is set to separate groups and a discussion is set to all participants the action area and action menu will not display to students.
# Replies in the discussion pane will display based on the reply hierarchy and depth.
# If the teacher is the creator of the discussion or reply their name will be denoted in bold and the screen reader will read “Teacher” before reading the poster’s name.
# Anywhere in the below action menus if the action is subscribe it will be replaced with unsubscribe if the user is already subscribed to the discussion.
# Anywhere in the below action menus if the action bookmark is available the option remove bookmark will show if the discussion or reply is already bookmarked
# Anywhere in the below action menus if the action mark substantive is available the option Unmark substantive will show if the discussion or reply is already marked as substantive.
# Reply will display in the below action menus only if the user has permissions to create a reply
# Rating and view ratings will only display in the action menus if the rating setting is enabled for the forum.
# A teacher will have the following actions available when viewing their own discussion: (See [[#TeacherViewsOwnDiscussion|Mockup: Teacher Views Own Discussion]])
## Edit
## Delete
## View ratings (only displays if ratings are enabled for the forum)
## Subscribe (will not display if subscribed to the forum or forum subscription is disabled)
## Mark substantive
## Bookmark
## Reply
# A teacher will have the following actions available when viewing their own reply: (See [[#TeacherViewsTeacherReply|Mockup: Teacher Views Teacher Reply]])
## Edit
## Split
## Delete
## View ratings (only displays if ratings are enabled for the forum)
## Mark substantive
## Bookmark
## Reply
# A teacher will have the following actions available when viewing a student’s reply: (See [[#TeacherViewsStudentReply|Mockup: Teacher Views Student Reply]])
## Reply
## Split
## Delete
## Rate (only displays if ratings are enabled for the forum)
## Mark substantive
## Bookmark
# A student will have the following actions available when viewing a discussion: (See [[#StudentViewsDiscussion|Mockup: Student Views Discussion]])
## Reply
## Rate
## Subscribe
# A student will have the following actions available when viewing their own reply: (See [[#StudentViewsOwnReply|Mockup: Student Views Own Reply]])
## Edit
## Delete
## Reply
# A private reply will display only to the student who created the original reply and the teachers.
# A teacher will have the following options available when viewing a private reply: (See [[#TeacherViewPrivateReply|Mockup: Teacher View Private Reply]])
## Edit
## Split
## Delete
# The action area and menu will not display to a student for a private reply.
# The user’s picture will display as the default user picture for an anonymous forum. See ([[#AnonymousReply|Mockup: Anonymous Reply]])
# The user’s name will appear as a Anonymous user instead of the creators real name.
# A user will have all the same action menu menu items for an anonymous reply as they would for a reply of the same type in a regular forum.
# A user will be able to use the spacebar to open the action menu
# A user will be able to use the tab key to navigate to a post’s action menu
# A user will be able to use the enter key to select an action menu item.
# Selecting the reply action will bring up the reply form below the post the user is replying to.
# The student reply modal will have the fields in [[#StudentReplyFormInline|Mockup: Student Reply Form Inline]]
# The file upload area will not display if the forum is set to not allow attachments.
# The teacher reply form will have the following additional form fields compared to a student’s reply form based on the type of forum and the forum settings: See ([[#TeacherReplyFormInline|Mockup: Teacher Reply Form Inline]])
## Mail now
## Group (select box with available groups if the forum is set to visible or separate groups)
## Private reply
## Reveal yourself in this post (if the forum is set to anonymous)
# Clicking the ''Post to forum'' button in the reply form will cause the following things to happen:
## The reply is added as the last reply to the post the user selected reply for
## The discussion tree view is updated to reflect the added reply if the parent post is expanded
## The user’s browser focus is placed on the header of the newly created reply.
# Clicking the ''Cancel'' button in the reply form will cause the following things to happen:
## The reply form stops displaying inline below the current post
## The user’s browser focus is placed on the header of the post the user was replying to.
# Selecting the split action will bring up the split post modal. See ([[#SplitPostModal|Mockup: Split Post Modal]])
# The split post modal will key the keyboard locked in the modal until the user clicks the ''Close'', ''Cancel'', or ''Split'' button.
# Clicking the ''Split'' button in the split modal will cause the following things to happen:
## The Split post modal to close
## The post converted to the initial discussion post for the new discussion with the title in the new discussion title field of the modal
## The reply hierarchy for the post are still associated with the post
## The discussion display pane will display the new discussion that the post was split into.
## The user’s browser focus is placed on the header for the initial post of the new discussion
## The discussion tree in the forum and discussion pane is updated to reflect the changes to the forum hierarchy
# Selecting the delete action will bring up a conformation that the user wants to delete the reply or discussion. See ([[#DeleteReplyModal|Mockup: Delete Reply Modal]])
# Clicking the ''Delete post'' button in the delete post modal will do the following things:
## Close the modal
## Remove the post and the reply in the hierarchy attached to the post and lower.
## Add a message to the message output stating “The <post header> was successfully deleted”.
## The user’s browser focus will be placed on the success message.
# The delete post modal will keep the keyboard locked in the modal until the user clicks the ''Close'', ''Cancel'', or ''Delete post'' button.
# Selecting the edit action will bring up the reply form inline pre-populated with the post that is being edited. See ([[#EditReplyForumInline|Mockup: Edit Reply Form Inline]])
# Selecting the rate action will bring up the rate modal pre-populated with the current rating the user has given the post. See [[#RatingModal|Mockup: Rating Modal]]
# The rate post modal will key the keyboard locked in the modal until the user clicks the ''Close'', ''Cancel'', or ''Rate post'' button.
# Clicking the ''Rate'' button in the rate modal will cause the following things to happen:
## The rate post modal will close
## The rating the user had entered will be saved for the post
## The rating for the post will update based on the forum settings.
## A message will be added the message output area stating “The rating was successfully saved” with a link to jump back to the post within the discussion display panel.
# Selecting the view ratings action will bring up the view ratings modal. See ([[#ViewRatingsModal|Mockup: View Ratings Modal]])
# The view ratings modal will keep the user’s keyboard focus until the user clicking on the ''Close'' or ''Close this window'' button.
# Closing a modal using the ''Close'', ''Close this window'' or ''Cancel'' buttons will place the user’s browser focus back on the action menu the user was on when they opened the modal.
# Any errors in the processing of a modal will display an error message in the message output area with a link back to the area the user was in when the error occurred.
# Selecting the ''Subscribe'' action will do the following things:
## Subscribe the user to the discussion to receive emails when new replies are created in the discussion
## Display a message in the message output stating that the user has been subscribed to the discussion
## Place the user’s browser focus on the message output.
# Selecting the ''Unsubscribe'' action will do the following things:
## Unsubscribe the user from the discussion and cause the user to stop receiving emails when new replies are created in the discussion
## Display a message in the message output stating that the user has been unsubscribed to the discussion
## Place the user’s browser focus on the message output.
# Selecting the ''Bookmark'' action will do the following things:
## Add the bookmark flag to the post
## Display a message in the message output stating that the post was bookmarked
## The message will end with a link to jump to the post that was bookmarked.
## Place the user’s browser focus on the message output
# Selecting the ''Remove bookmark'' action will do the following things:
## Remove the bookmark flag from the post
## Display a message in the message output stating that the bookmark has been removed from the post
## The message will end with a link to jump to the post that the bookmark was removed from.
## Place the user’s browser focus on the message output
## The message will end with a link to jump to the post that the bookmark was removed from.
# Selecting the ''Mark substantive'' action will do the following things:
## Add the substantive flag to the post
## Display a message in the message output stating that the post was flagged as substantive
## The message will end with a link to jump to the post that was flagged as substantive
## Place the user’s browser focus on the message output
# Selecting the ''Unmark substantive'' mark_ action will do the following things:
## Remove the substantive flag from the post
## Display a message in the message output stating that the substantive flag was removed from the post
## The message will end with a link to jump to the post the substantive flag was removed from.
## Place the user’s browser focus on the message output

===== Mockups =====

====== Discussion Display Pane Structure ======

[[Image:afDiscussionDisplayPaneStructure.png|afDiscussionDisplayPaneStructure.png]]

====== Discussion/Reply Structure ======

[[Image:afReplyStructure.png|afReplyStructure.png]]

====== Teacher Views Own Discussion ======

[[Image:afTeacherViewOwnDiscussion.png|afTeacherViewOwnDiscussion.png]]

====== Teacher Views Teacher Reply ======

[[Image:afTeacherViewTeacherReply.png|afTeacherViewTeacherReply.png]]

====== Teacher Views Student Reply ======

[[Image:afTeacherViewStudentReply.png|afTeacherViewStudentReply.png]]

====== Student Views Discussion ======

[[Image:afStudentViewDiscussion.png|afStudentViewDiscussion.png]]

====== Student Views Own Reply ======

[[Image:afStudentViewOwnReply.png|afStudentViewOwnReply.png]]

====== Teacher View Private Reply ======

[[Image:afPrivateReply.png|afPrivateReply.png]]

====== Anonymous Reply ======

[[Image:afAnonymousReply.png|afAnonymousReply.png]]

====== Student Reply Form Inline ======

[[Image:afStudentReplyModal.png|afStudentReplyModal.png]]

====== Teacher Reply Form Inline ======

[[Image:afTeacherReplyModal.png|afTeacherReplyModal.png]]

====== Rating Modal ======

[[Image:afRatingModal.png|afRatingModal.png]]

====== Split Post Modal ======

[[Image:afSplitModal.png|afSplitModal.png]]

====== Delete Post Modal ======

[[Image:afDeletePostModal.png|afDeletePostModal.png]]

====== Edit Reply Form Inline ======

[[Image:afEditModal.png|afEditModal.png]]

====== View Ratings Modal ======

[[Image:afViewRatingsModal.png|afViewRatingsModal.png]]

===== Use Cases =====

====== Student Listens to a Discussion Created by a Teacher ======

'''Description'''

A student selects a discussion using a screen reader and keyboard and listens to the screen reader read the discussion post.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the forum
# The student is using a screen reader
# The student has set the accessible forum display
# More than one discussion has been created by the teacher
# Replies have been posted to discussions

'''Steps'''

# The student uses the F6 key to get to the filter pane
# The student uses the F6 key to get to the forum and discussion pane
# The student uses the enter key to select the discussion

'''Postconditions'''

# The student is able to identify that the teacher created the discussion and not just another student.

====== Student Navigates Between Replies to a Discussion Using a Keyboard ======

'''Description'''

A student navigates between reply headings using the screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the forum
# The student is using a screen reader
# The student has set the accessible forum display
# More than one discussion has been created by the teacher
# The student has made a reply to a discussion

'''Steps'''

# The student uses the F6 key to get to the filter pane
# The student uses the F6 key to get to the forum and discussion pane
# The student uses the enter key to select the discussion
# The student uses the screen readers next header function to locate the next reply

'''Postconditions'''

# The student can identify by the header where they are within the forum hierarchy.
# The student is able to quickly navigate to each reply

====== Student Replies to a Discussion Using a Keyboard ======

'''Description'''

A student creates a reply to a discussion using a screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the forum
# The student is using a screen reader
# The student has set the accessible forum display
# More than one discussion has been created by the teacher
# Replies have been posted to discussions

'''Steps'''

# The student uses the F6 key to get to the filter pane
# The student uses the F6 key to get to the forum and discussion pane
# The student uses the enter key to select the discussion
# The student hits the tab key to tab to the action menu for the discussion
# The student hits the spacebar to open the action menu
# The student uses the down arrow to navigate to the reply action
# The student hits the enter key
# The student uses the tab key to tab through the forum fields and enter a reply
# The student tabs to the ''Post to forum'' button
# The student hits the enter key

'''Postconditions'''

# The reply is added to the discussion display pane in the proper place
# The student hears the header of the new reply

====== Student Edits a Reply Using a Keyboard ======

'''Description'''

A student edits a reply they have made using a screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the forum
# The student is using a screen reader
# The student has set the accessible forum display
# More than one discussion has been created by the teacher
# The student has made a reply to a discussion

'''Steps'''

# The student uses the F6 key to get to the filter pane
# The student uses the F6 key to get to the forum and discussion pane
# The student uses the enter key to select the discussion
# The student uses the screen readers next header keyboard commands to locate the reply they want to edit.
# The student hits the tab key to tab to the action menu for the discussion
# The student uses the spacebar to open the action menu
# The student uses the down arrow to select the edit menu item
# The student uses the enter key to select the edit menu item
# The student uses the tab key to navigate to the field they want to change
# The student uses the tab key to navigate to the ''Post to forum'' button
# The student hits the enter key to post the edits to the forum

'''Postconditions'''

# The reply is updated in the discussion display pane in the proper place
# The student hears the header of the edited reply

====== Student Subscribes to a Discussion Using a Keyboard ======

'''Description'''

A student subscribes to a discussion using a screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the forum
# The student is using a screen reader
# The student has set the accessible forum display
# More than one discussion has been created by the teacher
# The forum is set to optional forum subscriptions.
# The student is not subscribed to the forum
# The student has not subscribed to the discussion

'''Steps'''

# The student uses the F6 key to get to the filter pane
# The student uses the F6 key to get to the forum and discussion pane
# The student uses the enter key to select the discussion
# The student uses the screen readers next header keyboard commands to locate the reply they want to subscribe to.
# The student hits the tab key to tab to the action menu for the discussion
# The student uses the spacebar to open the action menu
# The student uses the down arrow to select the subscribe menu item
# The student uses the enter key to select the subscribe menu item

'''Postconditions'''

# The student is subscribed to the discussion
# A message is displayed in the message output area stating that the student has been subscribed to the discussion.
# The student hears the message

====== Student Accesses a Discussion’s Action Menu Using a Mouse ======

'''Description'''

A student displays a discussion’s action menu using a mouse.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the forum
# The student is using a screen reader
# The student has set the accessible forum display
# More than one discussion has been created by the teacher

'''Steps'''

# The student clicks on the discussion
# The student clicks on the action menu for the discussion

'''Postconditions'''

# The action menu expands

====== Teacher Rates a Post Using a Keyboard ======

'''Description'''

A teacher rates a student’s post using a screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a teacher
# An advanced forum has been created in the course
# The teacher has navigated to the course
# The teacher is using a screen reader
# The teacher has set the accessible forum display
# The teacher has created a discussion
# A student has made a reply to a discussion
# The forum is set to allow rating
# The student reply has not been rated

'''Steps'''

# The teacher uses the F6 key to get to the filter pane
# The teacher uses the F6 key to get to the forum and discussion pane
# The teacher uses the enter key to select the discussion
# The teacher uses the screen readers next header keyboard commands to locate the reply they want to rate.
# The teacher hits the tab key to tab to the action menu for the discussion
# The teacher uses the spacebar to open the action menu
# The teacher uses the down arrow to select the rate menu item
# The teacher uses the enter key to select the rate menu item
# The teacher uses the spacebar to open the rating select box
# The teacher uses the down arrow to select the rating they want.
# The teacher hits the enter key to select the rating for the post
# The teacher uses the tab key to navigate to the rate button.
# The teacher uses the enter key to rate the post.

'''Postconditions'''

# The post is rated
# The post’s rating is recalculated
# A message is displayed in the message output area stating that the post has been rated and allowing the teacher to jump to the post they rated.
# The student hears the message

====== Teacher Deletes a Discussion Using a Keyboard ======

'''Description'''

A teacher deletes a discussion using a screen reader and keyboard

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a teacher
# An advanced forum has been created in the course
# The teacher has navigated to the course
# The teacher is using a screen reader
# The teacher has set the accessible forum display
# A discussion has been created in the forum
# A reply has been made to the discussion

'''Steps'''

# The teacher uses the F6 key to get to the filter pane
# The teacher uses the F6 key to get to the forum and discussion pane
# The teacher uses the enter key to select the discussion
# The teacher hits the tab key to tab to the action menu for the discussion
# The teacher uses the spacebar to open the action menu
# The teacher uses the down arrow to select the delete menu item
# The teacher uses the enter key to select the delete menu item
# The teacher uses the spacebar to open the delete select box
# The teacher listens to the modal window text
# The teacher uses the tab key to navigate to the delete post button.
# The teacher uses the enter key to delete post button to delete the post.

'''Postconditions'''

# The post is deleted
# A message is displayed in the message output area stating that the post has been deleted and allowing the teacher to jump back to the forum and discussion pane
# The student hears the message

====== Teacher the Views Ratings for a Post Using a Keyboard ======

'''Description'''

A teacher views the ratings that have been given for a student’s post using a screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a teacher
# An advanced forum has been created in the course
# The teacher has navigated to the course
# The teacher is using a screen reader
# The teacher has set the accessible forum display
# The teacher has created a discussion
# A student has made a reply to a discussion
# The teacher and others have rated a student’s reply

'''Steps'''

# The teacher uses the F6 key to get to the filter pane
# The teacher uses the F6 key to get to the forum and discussion pane
# The teacher uses the enter key to select the discussion
# The teacher uses the screen readers next header keyboard commands to locate the reply they want to view the ratings for.
# The teacher hits the tab key to tab to the action menu for the discussion
# The teacher uses the spacebar to open the action menu
# The teacher uses the down arrow to select the view ratings menu item
# The teacher uses the enter key to select the view ratings menu item

'''Postconditions'''

# The view ratings modal appears with all the ratings that have been submitted for the post.

====== Teacher Splits a Reply Using a Keyboard ======

'''Description'''

A teacher splits a reply into a new discussion using a screen reader and keyboard

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a teacher
# An advanced forum has been created in the course
# The teacher has navigated to the course
# The teacher is using a screen reader
# The teacher has set the accessible forum display
# The teacher has created a discussion
# The reply has multiple replies to it.

'''Steps'''

# The teacher uses the F6 key to get to the filter pane
# The teacher uses the F6 key to get to the forum and discussion pane
# The teacher uses the enter key to select the discussion
# The teacher uses the screen readers next header keyboard commands to locate the reply they want to split.
# The teacher hits the tab key to tab to the action menu for the discussion
# The teacher uses the spacebar to open the action menu
# The teacher uses the down arrow to select the split menu item
# The teacher uses the enter key to select the split menu item
# The teacher uses the tab key to tab to the new discussion title field and enters a discussion title
# The teacher tabs to the split button
# The teacher hits the enter key to split the reply

'''Postconditions'''

# A new discussion is created from the reply with the title provided in the new discussion title field
# A message appears in the message output area that states the reply was split.
# The teacher’s browser focus is set to the message output
# The discussion display pane shows the newly created discussion
# The discussion tree in the forum and discussion pane is updated with the new discussion.

====== Teacher Marks a Post as Substantive Using a Keyboard ======

'''Description'''

A teacher marks a post as substantive using a screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a teacher
# An advanced forum has been created in the course
# The teacher has navigated to the course
# The teacher is using a screen reader
# The teacher has set the accessible forum display
# The teacher has created a discussion
# A student has made a reply to a discussion

'''Steps'''

# The teacher uses the F6 key to get to the filter pane
# The teacher uses the F6 key to get to the forum and discussion pane
# The teacher uses the enter key to select the discussion
# The teacher uses the screen readers next header keyboard commands to locate the reply they want mark as substantive.
# The teacher hits the tab key to tab to the action menu for the discussion
# The teacher uses the spacebar to open the action menu
# The teacher uses the down arrow to select the mark substantive menu item
# The teacher uses the enter key to select the mark substantive menu item

'''Postconditions'''

# The post is marked as substantive
# A message is added to the message output area stating that the post has been marked substantive and a link is included to allow the teacher to jump to the post.
# The teacher’s browser focus is placed on the message output.
# The teacher hears the message read to them.

====== Teacher Bookmarks a Post Using a Keyboard ======

'''Description'''

A teacher bookmarks a post using a screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a teacher
# An advanced forum has been created in the course
# The teacher has navigated to the course
# The teacher is using a screen reader
# The teacher has set the accessible forum display
# The teacher has created a discussion
# A student has made a reply to a discussion

'''Steps'''

# The teacher uses the F6 key to get to the filter pane
# The teacher uses the F6 key to get to the forum and discussion pane
# The teacher uses the enter key to select the discussion
# The teacher uses the screen readers next header keyboard commands to locate the reply they want to view the ratings for.
# The teacher hits the tab key to tab to the action menu for the discussion
# The teacher uses the spacebar to open the action menu
# The teacher uses the down arrow to select the bookmark menu item
# The teacher uses the enter key to select the bookmark menu item

'''Postconditions'''

# The post is flagged as bookmarked
# A message is added to the message output area stating that the post has been bookmarked and a link is included to allow the teacher to jump to the post.
# The teacher’s browser focus is placed on the message output.
# The teacher hears the message read to them.

=== Glossary ===

* '''Reply depth:''' The hierarchical level that a reply is on. A reply to a discussion is reply depth 1. A reply to a reply is depth 2. A reply to a reply to a reply is depth 3. Example: Discussion (depth 0) Reply (depth 1) Reply 2 (depth 2) Replay 3 (depth 3) Reply 4 (depth 2) Replay 5 (depth 1)

=== Document Change Management ===

==== Revision Summary ====

# Switched from a reply modal to an inline reply form to allow the user to navigate back up in the discussion hierarchy to listen to the post they are replying to.

==== Revision History ====

# Jason Hardin 20130812: Updated the specification to remove the reply modals and replace the references with inline forms. Updated some language to make the requirements make more sense.

=== Open Questions ===

# Is the breadcrumb required in Moodle for the forum?
# Does the breadcrumb need to be dynamically updated based on the user’s selection in the discussion tree?

==See also==
[[Category: Project]]

File:afEditModal.png

2013-08-12T17:21:00Z

Psychoph: Psychoph uploaded a new version of "File:afEditModal.png"

File:afStudentReplyModal.png

2013-08-12T17:20:34Z

Psychoph: Psychoph uploaded a new version of "File:afStudentReplyModal.png"

File:afTeacherReplyModal.png

2013-08-12T17:20:21Z

Psychoph: Psychoph uploaded a new version of "File:afTeacherReplyModal.png"

File:afNewTopicModal.png

2013-08-12T17:20:06Z

Psychoph: Psychoph uploaded a new version of "File:afNewTopicModal.png"

Advanced Forums Accessible Display Specification

2013-08-12T17:15:25Z

Psychoph:

=== Visioning ===

==== Overview ====

The Moodle forums is not as accessible as it could be. In order to improve usability of forums for those with disabilities Moodlerooms is will enhance advanced forums to display discussions based on EASI: Equal Access to Software & Information’s accessible forum design.

==== Business Goals ====

# Progress towards NFB Certification
# Keep strategic clients
# Improve sales for prospects with high accessibility requirements.

==== Product Goals ====

# Increase the accessibility of forum discussion display
# Increase usability of forums

==== Business References ====

* University of Montana (UofM)
* National Federation of the Blind (NFB)
* Department of Education
* [[http://easi.cc/|ASI: EQUAL ACCESS TO SOFTWARE & INFORMATION]]
* [[http://webaim.org/|WebAIM]]
* [[http://collaborate.athenpro.org/group/moodle/|Moodle Accessibility Group]]

=== Scenarios ===

==== Administrator Sets Advanced Forums as the Forums for All Forums on a Site ====

The administrator needs to force all forums to be created as advanced forums to meet the institutions accessibility policy. To do this the administrator sets all news forums to be created as advanced forums and disabled each roles capabilities to create forums.

==== Teacher Restricts Number of Replies ====

In order to keep forum conversations on topic the student wants to keep the depth of replies to a minimal. After a number of replies to replies a user will not be able to create a reply to a reply.

==== A Visually Impaired Student Listens to Posts in a Course Forum ====

A student needs to review the new posts that students and students have posted to their course forums. Using a screen reader the student accesses the forum and listens to the replies that have been made in the forum.

==== A Visually Impaired Student Replies to a Post in a Course Forum ====

A student wants to reply to a discussion made by the student. Using a screen reader the student navigates to the discussion and hits return when they find the reply link. The student is then placed in a text editor to create their reply. The student then saves the reply by navigating to the post button.

==== A Visually Impaired Student Sorts Forum Discussions ====

A student wants to sort the discussions by which have the newest posts in order to understand what the latest changes are to the forum. The student navigates to the sort using a screen reader and hits enter when they have found the sort by newest post.

=== References ===

==== Jira ====

==== Technical ====

* [[http://easi.cc/archive/bb2013/recording/index.htm|Recording of a discussion on the accessible prototype (EASI)]]
* [[https://dl.dropboxusercontent.com/u/137779786/discussion_module_mockup/discussion_board-listview.html|Prototype of an accessible forum (ESAI) ]]
* [[http://www.oaa-accessibility.org/examples/|OpenAjax Accessibility examples]]
* [[http://webaim.org/techniques/keyboard/accesskey|WebAIM on keyboard shortcuts]]
* [Specs 2.4 Advanced Forums]

=== Feature Information ===

==== Advanced Forums Site Settings ====

===== Description =====

Advanced forums will allow administrators to set the default forum display (renamed from discussion display) for all users. Advanced forums will also allow a site administrator to set the default maximum reply depth.

===== Requirements =====

# Rename Discussion display to Forum display in advanced forums display types.
# A new checkbox administrative settings called Create news forums as advanced forums will be added to the activity’s administrative settings page. See [[#AdvancedForumAdministrativeSettings|Mockup: Advanced Forum Administrative Settings]]
# The default value for the Create news forums as advanced forums is unchecked aka no.
# A new select box administrative settings called Default forum display will be added to the activity’s administrative settings page. See [[#AdvancedForumAdministrativeSettings|Mockup: Advanced Forum Administrative Settings]]
# The default value for the Default forum display is default
# The possible values for the Default forum display will be:
## Accessible
## Default
## Nested
## Tree
# A new administrative settings called Maximum reply depth will be added to the activity’s administrative settings page. See [[#AdvancedForumAdministrativeSettings|Mockup: Advanced Forum Administrative Settings]]
# The default value for the Maximum reply depth will be 3. See [[#AdvancedForumAdministrativeSettings|Mockup: Advanced Forum Administrative Settings]]

===== Mockups =====

====== Advanced Forum Administrative Settings ======

[[Image:afAdminSettings.png|afAdminSettings.png]]

===== Use Cases =====

====== Administrator Sets Default Forum Display ======

'''Description'''

The administrator sets the default forum display to accessible.

'''Preconditions'''

# The user is logged in
# The user is assigned as a site administrator
# The user is at the site level

'''Steps'''

# The administrator clicks on the ''Plugins'' link group under the Settings block
# The administrator clicks on the ''Activity modules'' link group
# The administrator clicks on the ''Advanced forums'' link
# The administrator selects ''Accessible'' from the ''Default forum display'' select box
# The administrator clicks the ''Save changes'' button

'''Postconditions'''

# the settings are saved

====== Administrator Sets the Site to Create all News Forums as Advanced Forums ======

'''Description'''

The administrator sets the site to use advanced forums for all newly created news forums.

'''Preconditions'''

# The user is logged in
# The user is assigned as a site administrator
# The user is at the site level

'''Steps'''

# The administrator clicks on the ''Plugins'' link group under the Settings block
# The administrator clicks on the ''Activity modules'' link group
# The administrator clicks on the ''Advanced forums'' link
# The administrator clicks the checkbox to the left of Create all new forums as advanced forums
# The administrator clicks the ''Save changes'' button

'''Postconditions'''

# The settings are saved

====== Administrator Sets the Default Maximum Reply Depth ======

'''Description'''

The administrator sets the default maximum reply depth for all newly created forums to be 1.

'''Preconditions'''

# The user is logged in
# The user is assigned as a site administrator
# The user is at the site level

'''Steps'''

# The administrator clicks on the ''Plugins'' link group under the Settings block
# The administrator clicks on the ''Activity modules'' link group
# The administrator clicks on the ''Advanced forums'' link
# The administrator enters 1 in the text box to the right of the Maximum reply depth setting.
# The administrator clicks the ''Save changes'' button

'''Postconditions'''

# The settings are saved.

====== Administrator Creates a Course With an Advanced Forums News Forum ======

'''Description'''

The administrator creates a course with a news forum. The news forum is created as an advanced forum.

'''Preconditions'''

# The user is logged in
# The user is assigned as a site administrator
# The advanced forum setting create news forums as advanced forums is checked.
# The user is at the site level

'''Steps'''

# The administrator clicks the ''Courses'' link group
# The administrator clicks the ''Add/edit courses'' link
# The administrator clicks the ''Add a new course'' button
# The administrator fills out the course information
# The administrator clicks the ''Save changes'' button

'''Postconditions'''

# The news forum created for the course is an advanced forum.

==== Advanced Forum Accessible Settings ====

===== Description =====

A new setting will be added to the create a forum screen that will allow the student to restrict the maximum depth of replies for a discussion.

===== Requirements =====

# A new setting will be added to the create a forum screen under the general group called maximum [[#replydepth|reply depth]]. See [[#AdvancedForumDepthSetting|Mockup: Advanced Forum Depth Setting]]
# The default value for the maximum [[#replydepth|reply depth]] will be 3
# The maximum [[#replydepth|reply depth]] will be 7
# Once the [[#replydepth|reply depth]] in a discussion reaches maximum reply depth the a student will not be able to reply to the reply. See [[#MaximumReplyDepthDisplay|Mockup: Maximum Reply Depth Display]]
# When a teacher creates a reply to the maximum depth reply the reply will be marked automatically as a private reply.
# A teacher will be unable to uncheck the private reply checkbox for a reply to a reply at the maximum reply depth. See [[#TeacherReplytoaMaximumDepthReply|Mockup: Teacher Reply to a Maximum Depth Reply]]

===== Mockups =====

====== Advanced Forum Depth Setting ======

[[Image:afMaxDepthSetting.png|afMaxDepthSetting.png]]

====== Maximum Reply Depth Display ======

[[Image:afMaxReplyDepthDisplay.png|afMaxReplyDepthDisplay.png]]

====== Teacher Reply to a Maximum Depth Reply ======

[[Image:afMaxReplyPrivateReply.png|afMaxReplyPrivateReply.png]]

===== Use Cases =====

====== Teacher Creates a Forum with a Maximum Reply Depth of 2 ======

'''Description'''

The student wants to limit the reply depth to 2 to keep the students on track with the forum discussion.

'''Preconditions'''

# The user is logged in
# The users is assigned the student role in the course
# The user has navigated to the course
# The course is set to weeks or topics format

'''Steps'''

# The student clicks on the add activity link
# The student selects Advanced forum
# The student fills out the forum information
# The student selects one from the select box for maximum reply depth

'''Postconditions'''

# Users cannot reply to a reply or a reply
# The student can still create a private reply to a reply of a reply

====== A Student Views a Reply at the Maximum Reply Depth ======

'''Description'''

A student views a reply that is at the maximum reply depth.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course with a maximum reply depth
# The forum has multiple replies with one at the maximum reply depth
# The student has navigated to the course

'''Steps'''

# The student clicks on the forum
# The student scrolls to the reply at the maximum reply depth

'''Postconditions'''

# The student doesn’t see the reply link.

====== A Teacher Replies to a Maximum Reply Depth Reply ======

'''Description'''

The student wants to create a private reply to the student’s reply even though it is at the maximum reply depth.

'''Preconditions'''

# The user is logged in
# The user is assigned to the student role in a course
# An advanced forum has been created in the course with a maximum reply depth
# The forum has multiple replies with one at the maximum reply depth
# The student has navigated to the course

'''Steps'''

# The student clicks on the forum
# The student scrolls to the reply at the maximum reply depth
# The student clicks on the reply link
# The student fills out the reply form
# The student clicks the ''Post to forum'' button

'''Postconditions'''

# The Private reply checkbox is checked and disabled
# The student can’t change the reply to a non private reply.

==== Private Reply Display ====

===== Description =====

To improve the accessibility of private replies Moodlerooms will add a string to the front of private replies to identify them to the user.

===== Requirements =====

# Private replies will have the string Private reply: added to the front of the title for the reply. See [[#PrivateReplyDisplay|Mockup: Private Reply Display]]
# The string Private reply will be translatable.

===== Mockups =====

====== Private Reply Display ======

[[Image:afPrivateReply.png|afPrivateReply.png]]

===== Use Cases =====

====== Student Views a Private Reply ======

'''Description'''

A student views a private reply from a student in a forum.

'''Preconditions'''

# The user is logged in
# The user is assigned to the student role in a course
# The student has created a reply in a forum
# A student has created a private reply to the student’s reply
# The user has navigated to a course with a private reply in it

'''Steps'''

# The student clicks on the forum
# The student scrolls to view the private reply

'''Postconditions'''

# The string Private reply shows in front of the title for the reply.

==== Accessible Discussion Display ====

===== Description =====

The current display options in advanced forums do not maximize the view for those with disabilities. The accessible discussion display will work to implement the prototype of an accessible forum by ESAI. Users will be able to switch between this discussion display and any other discussion display types.

===== Requirements =====

[test]

# A new discussion display mode will be added to the forum display drop down called accessible.
# The accessible forum display will be separated into 5 areas (See [[#AccessibleDisplayStructure|Mockup: Accessible Display Structure]])
## Moodle breadcrumb at the top
## Filter pane at the top
## Forum description (Only shown if set)
## Forum and Discussion selection pane on the left
## Discussion display pane on the right
# Forum management will still be maintained within Moodle’s navigation and settings blocks and accessed via the themes block display.
# The breadcrumb will initially display the full moodle path to the forum the user selected within the course. See [[#NoDiscussionSelected|Mockup: No Discussion Selected]]
# The user will be able to use skip navigation to jump to the forum/discussion pane. See [[#AccessibleDisplayStructure|Mockup: Accessible Display Structure]]
# Navigation from the Discussion display pane to the Forum and Discussion selection pane
# The access key 1 will be used to move to the focus to the Forum select box
# The access key 2 will be used to move the focus to the discussion selection tree view
# The F6 key will be used to to switch focus to the next pane of the filter, forum and discussion and the discussion display panes. See [[#AccessibleDisplayStructure|Mockup: Accessible Display Structure]]
# The Shift+F6 keys will be used to switch focus to the previous pane of the filter, forum and discussion and the discussion display panes. See [[#AccessibleDisplayStructure|Mockup: Accessible Display Structure]]
# When navigating between panes a screen reader will be informed of the region the user has navigated to.

====== Accessible Display Structure ======

[[Image:afAccessibleDisplayStructure.png|afAccessibleDisplayStructure.png]]

====== No Discussion Selected ======

[[Image:afNoDiscussionSelected.png|afNoDiscussionSelected.png]]

===== Use Cases =====

====== Student Selects Accessible Forum Display ======

'''Description'''

A student will a visual disability wants to maximize their usability of advanced forums and selects the accessible forum display type.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course with a maximum reply depth
# The student has navigated to the course
# The student is using a screen reader

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the screen reader to skip to the main content of the page
# The student tabs to the forum display select drop down
# The student uses the space button to open the the select drop down
# The student uses the arrow keys to highlight the accessible select option
# The student hits the enter key

'''Postconditions'''

# The page reloads
# The accessible forum display appears

====== Student Uses F6 to Navigate Between Panes ======

'''Description'''

A visually impaired user wants to quickly change between the panes in the accessible forum view using the F6 key.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student hits the F6 key

'''Postconditions'''

# The student is taken to the filter pane
# The student is informed they are in the filter region

====== Student Uses Shift+F6 to Navigate Between Panes ======

'''Description'''

A student wants to navigate back through the panes of the accessible forum display using the shift+F6 key combination.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student hits the Shift+F6 key combination

'''Postconditions'''

# The student is taken to the discussion display pane
# The student is informed they are in the discussion display region

====== Student Uses Access key 1 to Navigate to the Forum Selection box ======

'''Description'''

A student wants to jump directory to the forum selector to change the forum they are viewing.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student clicks the screen reader’s key combination for the access 1 key

'''Postconditions'''

# The keyboard focus is set of the forum selector box box

====== Student Uses Access key 2 to Navigate to the Discussion Selection Tree view ======

'''Description'''

A student wants to jump to the discussion tree selector to quickly select a new reply to listen to.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student clicks the screen reader’s key combination for the access 2 key

'''Postconditions'''

# The keyboard focus is set of the discussion selector tree view box

==== Accessible Forum Display Filter Pane ====

===== Description =====

In order to quickly access the information users need from the forums they will need to be able to sort and filter the discussions in the forum. Users will also need to be able to change the forum display to their preferred display from the default or current display.

===== Requirements =====

{note}See original [Specs 2.4 Advanced Forums] for how discussions are sorted using each sort by type{note}

# The filter pane will display the following menus based on the forum configuration for the teacher: (See [[#FilterPaneExpandedTeacher|Mockup: Filter Pane Expanded Teacher]])
## Group menu (only displayed if visible or separate groups is set for the forum)
### All participants
### List of all groups in the grouping assigned to the forum.
## Sort by (each menu item will have a sub menu for changing the sort to ascending or descending)
### Last post date
### Creation date
### Last name
### First name
### Number of replies
## Forum display
### Accessible
### Default
### Nested
### Tree
# The filter pane will display the following menus based on the forum configuration for the student: (See [[#FilterPaneExpandedStudent|Mockup: Filter Pane Expanded Student]])
## Sort by (each menu item will have a sub menu for changing the sort to ascending or descending)
### Last post date
### Creation date
### Last name
### First name
### Number of replies
## Forum display
### Accessible
### Default
### Nested
### Tree
# The filter pane will display the simple forum search form for all users. See [[#FilterPane|Mockup: Filter Pane]]
# The user will be able to tab to the first menu and the search field
# The user will use the left and right arrows to switch between menus and to open sub menus
# The user will use the up and down arrows to navigate between menu items
# The user will use the spacebar to open the menu
# Selecting a sort by option will open up the ascending or descending sub menu. See [[#FilterPaneExpandedStudent|Mockup: Filter Pane Expanded Student]]
# Selecting ascending or descending in a sort by submenu will rest the discussion display pane to its default state. See [[#NoDiscussionSelected|Mockup: No Discussion Selected]]
# Selecting ascending or descending in a sort by submenu will rest the page’s Moodle breadcrumb to the path to the current forum. See [[#NoDiscussionSelected|Mockup: No Discussion Selected]]
# Selecting ascending or descending will sort the discussion list based on the sort by and ascending or descending selection.
# Selecting ascending or descending will set the student’s focus to the Discussion tree view.
# If the forum is not set to use groups in the forum settings then the view group menu in the top navigation will not display. See [[#FilterPaneExpandedStudent|Mockup: Filter Pane Expanded Student]]
# Selecting a group in the view group selector will change the discussion pane to display only discussions for that group and all participants.
# Selecting a group in the view group selector will focus the user on the Discussion tree view
# Selecting a group will reset the discussion view pane to its default state of no discussion or reply being displayed. See [[#NoDiscussionSelected|Mockup: No Discussion Selected]]
# Selecting a group will reset the Moodle breadcrumb to the path to the current forum. See [[#NoDiscussionSelected|Mockup: No Discussion Selected]]
# Selecting a display type in the forum display menu will cause the page to reload and the new forum display to display the forum. See [[#NoDiscussionSelected|Mockup: No Discussion Selected]]
# Clicking the ''Search'' button will bring up the search results in the discussion display pane. See [[#SearchResults|Mockup: Search Results]]
# The search one the filter pane will search only the current forum.
# Clicking the ''Advanced search'' button will display the Advanced search modal. See [[#AdvancedSearchModal|Mockup: Advanced Search Modal]]
# The advanced search modal will lock the user’s keyboard in the modal until the user click the ''Close'', ''Cancel'', or ''Search forums'' button.
# Clicking the ''Search'' button on the filter pane or the ''Search forums'' button in the advanced search modal will display the search results in the discussion display pane. See [[#SearchResults|Mockup: Search Results]]
# The user’s browser focus will be placed on the discussion display pane after a search has finished.
# The search results will display the same as described in the [[#AccessibleForumDiscussionDisplayPane|Section: Accessible Forum Discussion Display Pane]] with a header titled Search results with a count of the number of posts found.
# The action menu for each post in the search results will consist of the following links: (See [[#SearchResults|Mockup: Search Results]])
## Show post in full discussion
## Show post and its replies
# Selecting Show post in full discussion in the action menu will cause the following to happen:
## The discussion display pane will display all posts in the discussion the post is in.
## The user’s browser focus will be placed on the post in the discussion display pane
# Selecting Show post and its replies in the action menu will cause the following to happen:
## The discussion display pane display the post and all replies to the post in the discussion hierarchy.
## The user’s browser focus will be placed on the post in the discussion display pane

===== Mockups =====

====== Filter Pane ======

[[Image:afFilterPane.png|afFilterPane.png]]

====== Filter Pane Expanded Teacher ======

[[Image:afFilterPaneExpandedTeacher.png|afFilterPaneExpandedTeacher.png]]

====== Filter Pane Expanded Student ======

[[Image:afFilterPaneExpandedStudent.png|afFilterPaneExpandedStudent.png]]

====== Search Results ======

[[Image:afSearchResults.png|afSearchResults.png]]

====== Advanced Search Modal ======

[[Image:afAdvancedSearchModal.png|afAdvancedSearchModal.png]]

===== Use Cases =====

====== Student Accesses the Sort by Menu Using a Keyboard ======

'''Description'''

A student accesses the sort by menu drop down using a screen reader and their keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the screen reader to jump to the main content
# The student uses the tab key to tab to the sort by menu

'''Postconditions'''

# Using the tab key the student is able to find the sort by menu
# The student is able to identify using the screen reader which menu they are on.

====== Student Accesses the Search Field Using a Keyboard ======

'''Description'''

A student accesses the search input field using a screen reader and their keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the screen reader to jump to the main content
# The student uses the tab key to tab to the search input field

'''Postconditions'''

# The student is able to identify that entering text in the field will search to forum for posts with that information in it.
# The student is able to identify they are in a form and need to tab to the ''Search forum'' button

====== Student Opens Sort By Menu Using a Keyboard ======

'''Description'''

A student opens the sort by menu using a screen reader and their keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the screen reader to jump to the main content
# The student uses the tab key to tab to the sort by menu
# The student uses the spacebar to open the sort by menu

'''Postconditions'''

# The sort by menu opens for the student
# The screen reader reads all of the sort by menu items.

====== Student Selects Sort By Number of Replies Descending Using a Keyboard ======

'''Description'''

A student selects sort by number or replies in a descending order using a screen reader and their keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display
# The advanced forum has more than 1 discussion and reply

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the screen reader to jump to the main content
# The student uses the tab key to tab to the sort by menu
# The student uses the spacebar to open the sort by menu
# The student uses the down arrow key to locate the ''Number of replies'' menu item
# The student uses the right arrow key to open the ''Number of replies'' sub menu
# The student uses the down arrow key to select the ''Descending'' menu item

'''Postconditions'''

# The discussion list is resorted by number of replies in a descending order
# The student’s browser focus is set to the discussion tree view
# The student is able to understand via the screen reader that they are not accessing the discussion tree view.

====== Student Navigates Between Menus Using a Keyboard ======

'''Description'''

A student accesses each menu using a keyboard and screen reader.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the screen reader to jump to the main content
# The student uses the tab key to tab to the sort by menu
# The student uses the left arrow key to navigate to the forum display menu

'''Postconditions'''

# The student is able to navigate to the forum display using the keyboard

====== Student Selects a Display Type Using a Keyboard ======

'''Description'''

A student changes the display type from accessible to default using a screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the screen reader to jump to the main content
# The student uses the tab key to tab to the sort by menu
# The student uses the left arrow key to navigate to the forum display menu
# The student uses the spacebar to open the forum display menu
# The student uses the down arrow key to select a new forum display type

'''Postconditions'''

# The student is able to navigate to the forum display using the keyboard
# The page is reloaded and the forum is displayed using the new forum display type

====== Teacher Selects a Group Using a Keyboard ======

'''Description'''

A student filters the lists of discussions by group using a screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display
# The advanced forum is setup to have separate groups
# Students are assigned to groups
# The forum has posts to each group as well as all participants.

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the screen reader to jump to the main content
# The student uses the tab key to tab to the sort by menu
# The student uses the left arrow key to navigate to the view group menu
# The student uses the spacebar to open the view group menu
# The student uses the down arrow key to select a group to view

'''Postconditions'''

# The discussion tree view is updated with the discussions available to the selected group and all participants
# The student’s browser focus is set to the discussion tree view.

====== Student Searches the Forum Using a Keyboard ======

'''Description'''

A student uses a screen reader and keyboard to access the search input field in the filter pane and search the forum.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display
# There are discussion in the forum
# There are replies in the forum
# There are replies or discussions that match the search criteria in the forum.

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the F6 key to navigate to the filter pane
# The student tabs to the search input field
# The student enters their search text in the search input field
# The student tabs to the search button
# The student hits the enter key to search the forums

'''Postconditions'''

# The posts that are found matching the search criteria display in the discussion display pane
# The user’s browser focus is set to the discussion display pane.

====== Student Uses the Advanced Search to Search the Forum Using a Keyboard ======

'''Description'''

A student search the forum using the advanced search modal, a screen reader and a keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display
# There are discussion in the forum
# There are replies in the forum
# There are replies or discussions that match the search criteria in the forum.

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the F6 key to navigate to the filter pane
# The student tabs to the advanced search button
# The student hits the enter key
# The student uses the tab key to fill out the search criteria
# The student tabs to the search forum button
# The student hits enter to search the forum

'''Postconditions'''

# The posts that are found matching the search criteria display in the discussion display pane
# The user’s browser focus is set to the discussion display pane.

====== Student Displays the Discussion the Search Result is a Part of Using a Keyboard ======

'''Description'''

A student selects the to view the discussion that a search result post is a part of using a screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display
# There are discussion in the forum
# There are replies in the forum
# There are replies or discussions that match the search criteria in the forum.
# The user has finished searching via advanced search or simple search.

'''Steps'''

# The student uses the screen readers next header keyboard commands to locate the reply they want to edit.
# The student hits the tab key to tab to the action menu for the discussion
# The student uses the spacebar to open the action menu
# The student uses the down arrow to select the Show post in full discussion menu item
# The student uses the enter key to select the Show post in full discussion menu item

'''Postconditions'''

# The discussion pane displays the discussion that the post is in
# The user’s bowser focus is set to the post that Show post in full discussion was selected for.

====== Student Displays the Search Result and All Replies Using a Keyboard ======

'''Description'''

A student selects to display the search result post and all of its replies using a screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display
# There are discussion in the forum
# There are replies in the forum
# There are replies or discussions that match the search criteria in the forum.
# The user has finished searching via advanced search or simple search.

'''Steps'''

# The student uses the screen readers next header keyboard commands to locate the reply they want to edit.
# The student hits the tab key to tab to the action menu for the discussion
# The student uses the spacebar to open the action menu
# The student uses the down arrow to select the Show post and its replies menu item
# The student uses the enter key to select the Show post and its replies menu item

'''Postconditions'''

# The discussion pane displays the post and all of its sub replies
# The user’s bowser focus is set to the post that Show post and its replies was selected for.

==== Accessible Forum Display Forum and Discussion Pane ====

===== Description =====

The forum and discussion pane is designed to provide the user with quick access to overall activity within the forum. This is where the user quickly navigates to the discussion or reply they want to view in the discussion pane.

===== Requirements =====

# The Forum and discussion pane will display the following: (See [[#ForumandDiscussionPane|Mockup: Forum and Discussion Pane]])
## A drop down list of all forums in the course with the current forum selected
## A button to ''Add a new discussion topic''
## If visible or separate groups is set for the forum a statement of the setting will display below the forum select box. See [[#ForumandDiscussionPaneSeparateGroups|Mockup: Forum and Discussion Pane Separate Groups]] and [[#ForumandDiscussionPaneVisibleGroups|Mockup: Forum and Discussion Pane Visible Groups]]
## An expandable collapsable list of all discussions and replies in the currently selected forum the user can view.
# The forum selector drop down will not appear if there is only one forum in the course
# The forum selector will list all advanced forums in the course in alphabetical order
# Selecting a forum from the forum drop down will reload the page as if the user had clicked on the forum in the course.
# The ''Add a new discussion topic'' button will not appear for users if they do not have permissions to create a discussion.
# Clicking the ''Add a new discussion topic'' will display the ''Your new discussion topic'' forum in the discussion pane. See [[#NewDiscussionTopic|Mockup: New Discussion Topic]]
# Clicking the ''Post to forum'' button in the ''Your new discussion topic'' form causes the following to happen:
## Save the discussion to the forum
## Add the discussion title in the correct sort order to the discussion tree
## Display the new discussion in the discussion pane
## Place the browser focus on the new discussion.
# Clicking the ''Cancel'' button will cause the following to happen:
## Close the reset the discussion pane to the default state when no discussion is selected
## Return the user’s browser focus to the ''Add a new discussion topic'' button.
# The user will use tab to navigate between the forum selector, add a new discussion topic button and discussion tree.
# A group selector option will display below the mail now form field if a forum is set to separate or visible groups.
# The user will use the up and down arrows to navigate up and down in the discussion tree. See [[#ForumandDiscussionPaneExpanded|Mockup: Forum and Discussion Pane Expanded]]
# The user will use the left and right arrows to expand and contract the discussion tree. See [[#ForumandDiscussionPaneExpanded|Mockup: Forum and Discussion Pane Expanded]]
# The user will be able to use the mouse to click on the + and - images to expand and contract discussions and replies. See [[#ForumandDiscussionPaneExpanded|Mockup: Forum and Discussion Pane Expanded]]
# Discussions that are collapsed and have replies will have a + image to the left of the discussion title and the screen reader will read that the discussion is collapsed. See [[#ForumandDiscussionPaneExpanded|Mockup: Forum and Discussion Pane Expanded]]
# Replies that are collapsed and have replies will have a + image to the left of the reply title and the screen reader will read that the reply is collapsed. See [[#ForumandDiscussionPaneExpanded|Mockup: Forum and Discussion Pane Expanded]]
# Discussions that are expanded and have replies will have a - image to the left of the discussion title and the screen reader will read that the discussion is expanded. See [[#ForumandDiscussionPaneExpanded|Mockup: Forum and Discussion Pane Expanded]]
# Replies that are expanded and have replies will have a - image to the left of the reply title and the screen reader will read that the reply is expanded. See [[#ForumandDiscussionPaneExpanded|Mockup: Forum and Discussion Pane Expanded]]
# When expanded a discussion or reply will display all replies to the discussion in tree form below it. See [[#ForumandDiscussionPaneExpanded|Mockup: Forum and Discussion Pane Expanded]]
# If a discussion or reply has no replies to it then no image will display to the left of the title. See [[#ForumandDiscussionPaneExpanded|Mockup: Forum and Discussion Pane Expanded]]
# Users will use the enter key on a discussion to display the discussion and all replies in the discussion pane. See [[#DiscussionAccessibleDisplay|Mockup: Discussion Accessible Display]]
# Users will click on a discussion to display the discussion and all replies in the discussion pane. See [[#DiscussionAccessibleDisplay|Mockup: Discussion Accessible Display]]
# Users will use the enter key on a reply to display the reply and all replies to the reply in the discussion pane. See [[#SelectedReplyAccessibleDisplay|Mockup: Selected Reply Accessible Display]]
# Users will click on a reply to display the replies and all replies to the reply in the discussion pane. See [[#SelectedReplyAccessibleDisplay|Mockup: Selected Reply Accessible Display]]
# Clicking on a reply or discussion will place the user’s browser focus on the discussion pane
# Hitting the enter key on a discussion or reply link will place the user’s browser focus on the discussion pane.
# The discussion tree will display the number of unread replies for the discussion/reply to the right of the discussion/reply title if the user has read tracking enabled. See [[#ForumandDiscussionPane|Mockup: Forum and Discussion Pane]]
# Forums set to visible or separate groups will add the for and group name to the right of the discussion title when the post is set to a specific group in the discussion tree view. See [[#ForumandDiscussionPaneSeparateGroups|Mockup: Forum and Discussion Pane Separate Groups]] and [[#ForumandDiscussionPaneVisibleGroups|Mockup: Forum and Discussion Pane Visible Groups]]

===== Mockups =====

====== Forum and Discussion Pane ======

[[Image:afForumDiscussionPane.png|afForumDiscussionPane.png]]

====== Forum and Discussion Pane Expanded ======

[[Image:afForumDiscussionPaneExpanded.png|afForumDiscussionPaneExpanded.png]]

====== Forum and Discussion Pane Separate Groups ======

[[Image:afForumDiscussionPaneSeparateGroups.png|afForumDiscussionPaneSeparateGroups.png]]

====== Forum and Discussion Pane Visible Groups ======

[[Image:afForumDiscussionPaneVisibleGroups.png|afForumDiscussionPaneVisibleGroups.png]]

====== Discussion Accessible Display ======

[[Image:afAccessibleDiscussionDisplay.png|afAccessibleDiscussionDisplay.png]]

====== Selected Reply Accessible Display ======

[[Image:afAccessibleReplyDisplay.png|afAccessibleReplyDisplay.png]]

====== New Discussion Topic ======

[[Image:afNewTopicModal.png|afNewTopicModal.png]]

===== Use Cases =====

====== Student Uses a Keyboard to Navigate Between Forum and Discussion Panel Areas ======

'''Description'''

A student navigates between the forum selector, add a new discussion topic and the discussion tree using a screen reader and their keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the F6 key to get to the filter pane
# The student uses the F6 key to get to the forum and discussion pane
# The student uses the tab key to navigate between the areas of the forum and discussion pane

'''Postconditions'''

# The student is able to navigate between the forum selector and discussion tree areas
# The student with the use of the screen reader understands the areas they are navigating between.

====== Student Selects a Different Forum Using a Keyboard ======

'''Description'''

A student navigates to a different forum without going back to the course page using a screen reader and their keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display
# The is more than one forum in the course

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the F6 key to get to the filter pane
# The student uses the F6 key to get to the forum and discussion pane
# The student tabs to the forum selector
# The student uses the spacebar to open the forum selector
# The student uses the down arrow to select the next forum in the course
# The student hits the enter key to select the forum

'''Postconditions'''

# The page is reloaded and the student is in the accessible view of the selected forum.

====== Teacher Adds a New Discussion Topic Using a Keyboard ======

'''Description'''

A teacher with a visual disability adds a new discussion topic to the forum using their screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a teacher
# An advanced forum has been created in the course
# The teacher has navigated to the course
# The teacher is using a screen reader
# The teacher has set the accessible forum display

'''Steps'''

# The teacher uses the screen reader to skip to the main content of the course
# The teacher tabs to the forum activity within the course
# The teacher hits the enter key
# The teacher uses the F6 key to get to the filter pane
# The teacher uses the F6 key to get to the forum and discussion pane
# The teacher uses the tab key to navigate to the ''Add a new discussion topic'' button
# The teacher hit the enter key
# The teacher uses tab to fill in all field in the ''Your new discussion topic'' form
# The teacher tabs to the ''Post to forum'' button
# The teacher hits the enter key

'''Postconditions'''

# The teacher’s post is saved
# The teacher’s browser focus is placed on the discussion pane.
# The discussion tree is updated with the new discussion.

====== Teacher Adds a New Discussion Topic For a Specific Group Using a Keyboard ======

'''Description'''

A teacher with a visual disability adds a new discussion topic to the forum using their screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a teacher
# An advanced forum has been created in the course
# The teacher has navigated to the course
# The teacher is using a screen reader
# The teacher has set the accessible forum display
# The advanced forum is set to separate groups

'''Steps'''

# The teacher uses the screen reader to skip to the main content of the course
# The teacher tabs to the forum activity within the course
# The teacher hits the enter key
# The teacher uses the F6 key to get to the filter pane
# The teacher uses the F6 key to get to the forum and discussion pane
# The teacher uses the tab key to navigate to the ''Add a new discussion topic'' button
# The teacher hit the enter key
# The teacher uses tab to fill in all field in the ''Your new discussion topic'' form
# The teacher selects a specific group from the group selector
# The teacher tabs to the ''Post to forum'' button
# The teacher hits the enter key

'''Postconditions'''

# The teacher’s post is saved
# The teacher’s browser focus is placed back on discussion pane.
# The discussion tree is updated with the new discussion.
# The discussion title has the words for <group name selected> to its right.

====== Student Expands a Discussion Using a Keyboard ======

'''Description'''

A student expands a discussion to listen to all of the replies to the discussion using a screen reader and their keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display
# More than one discussion has been created
# Replies have been posted to discussions

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the F6 key to get to the filter pane
# The student uses the F6 key to get to the forum and discussion pane
# The student uses the tab key to navigate to the discussion tree
# The student uses the left arrow key to expand the replies to the discussion

'''Postconditions'''

# All the titles for the replies of reply depth 1 for the discussion are showing and read to the user via the screen reader

====== Student Expands a Discussion Using a Mouse ======

'''Description'''

A student expands the replies to a discussion using their mouse.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student has set the accessible forum display
# More than one discussion has been created
# Replies have been posted to discussions

'''Steps'''

# The student clicks on the forum in the course
# The student clicks on the plus image to the left of the discussion title

'''Postconditions'''

# All the titles for the replies of reply depth 1 for the discussion are displayed

====== Student Navigated Down the Discussion Tree Using a Keyboard ======

'''Description'''

A student navigates to a reply to a discussion using a screen reader and their keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display
# More than one discussion has been created
# Replies have been posted to discussions

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the F6 key to get to the filter pane
# The student uses the F6 key to get to the forum and discussion pane
# The student uses the tab key to navigate to the discussion tree
# The student uses the down arrow to navigate to the next discussion in the tree

'''Postconditions'''

# The title of the discussion is read to the student via the screen reader

====== Student Selects a Discussion to Display Using a Keyboard ======

'''Description'''

A student selects a discussion using a screen reader and their keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display
# More than one discussion has been created
# Replies have been posted to discussions

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the F6 key to get to the filter pane
# The student uses the F6 key to get to the forum and discussion pane
# The student uses the tab key to navigate to the discussion tree
# The student uses the down arrow to navigate to the next discussion
# The student hits the enter key

'''Postconditions'''

# The student’s browser focus is set to the discussion pane
# The discussion pane is updated to display the full discussion plus all replies in the discussion.

====== Student Selects a Discussion Using a Mouse ======

'''Description'''

A student selects a discussion using their mouse.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student has set the accessible forum display
# More than one discussion has been created
# Replies have been posted to discussions

'''Steps'''

# The student clicks on the forum in the course
# The student clicks on the discussion title

'''Postconditions'''

# The student’s browser focus is set to the discussion pane
# The discussion pane is updated to display the full discussion plus all replies in the discussion.

====== Student Locates a Discussion With Unread Replies using a Keyboard ======

'''Description'''

A student navigates through the discussion tree until they hear a discussion that has new replies to it. The student is using the screen reader and their keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display
# More than one discussion has been created
# Replies have been posted to discussions

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the F6 key to get to the filter pane
# The student uses the F6 key to get to the forum and discussion pane
# The student uses the down arrow to located a discussion with unread replies

'''Postconditions'''

# Each discussion title is read as the user uses the down arrow to navigate down
# The discussion title is read then the number of unread replies.

====== Student Selects a Reply Using a Keyboard ======

'''Description'''

A student navigates to a reply and selects it to listen to in the discussion pane using a screen reader and their keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display
# More than one discussion has been created
# Replies have been posted to discussions

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the F6 key to get to the filter pane
# The student uses the F6 key to get to the forum and discussion pane
# The student uses the right arrow to expand a discussion
# The student hits the enter key

'''Postconditions'''

# The student’s browser focus is set to the discussion pane
# The discussion pane is updated to display the reply and all replies of a reply depth below the starting reply.

====== Student Selects a Reply Using a Mouse ======

'''Description'''

A student navigates to a reply and selects it to listen to in the discussion pane using their mouse.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student has set the accessible forum display
# More than one discussion has been created
# Replies have been posted to discussions

'''Steps'''

# The student clicks on the forum in the course
# The student clicks on the plus image to the left of the discussion title
# The student clicks on the reply title

'''Postconditions'''

# The student’s browser focus is set to the discussion pane
# The discussion pane is updated to display the reply and all replies of a reply depth below the starting reply.

==== Accessible Forum Discussion Display Pane ====

===== Description =====

The discussion display pane is the region of the forum that displays to the user the specific discussion or reply they have chosen with all sub replies. The pane is designed to present the selected discussion or reply in the most accessible manner focusing on simplified content and easy tabbing between actions. HTML headers are used to help inform the user where they are in the hierarchy of the discussion.

{note}It is understood that using HTML header’s to denote the hierarchy of the forum has the issue that HTML only has a header level up to H6. Furthermore H1 is only used once on a page and for the page heading. This is why the maximum reply depth setting has been added. It also should be noted that after a reply depth of 3 forum replies become less focused on the original discussion topic.{note}

===== Requirements =====

# The discussion pane will be separated into 2 areas: (See [[#DiscussionDisplayPaneStructure|Mockup: Discussion Display Pane Structure]])
## Message display area. This is a live area that is updated with message as information is added or removed.
## Discussion/reply display area. This is dynamically updated based on content changes and the forum and discussion pane.
# Messages in the message area will display for 30 seconds and then be removed from the page.
# The message output area will not be accessible by keyboard if there are no messages displayed within the area.
# Each discussion or reply will be separated into 3 areas: (See [[#Discussion/ReplyStructure|Mockup: Discussion/Reply Structure]])
## Heading
## Post
### Post text
### File attachments
## Actions
# A discussion/reply heading will display the following information in this order: (See [[#TeacherViewsOwnDiscussion|Mockup: Teacher Views Own Discussion]])
## Post title using the correct HTML header based on reply depth (see below)
## Author with their image and name, the image will not be identified to a screen reader (alt=“”)
## Post date, the date the post was created
## Rating type and value (this will only display if ratings are enabled for the forum)
# The accessible display mode will use HTML header tags (h2-h6) for the title of the discussion post and replies. See [[#DiscussionAccessibleDisplay|Mockup: Discussion Accessible Display]]
# The discussion post will use a h2 HTML header tag for the title of the post. See [[#DiscussionAccessibleDisplay|Mockup: Discussion Accessible Display]]
# A replies reply depth will determine the HTML header tag to be used for the title: (See [[#DiscussionAccessibleDisplay|Mockup: Discussion Accessible Display]])
## Reply depth 1 will use the HTML header h3
## Reply depth 2 will use the HTML header h4
## Reply depth 3 will use the HTML header h5
## Reply depth 4 will use the HTML header h6
# Forums that allow a reply depth greater then 4 will use the HTML Header tag of H6 for all reply titles at a depth of 4 or greater.
# The post text area will display the post text and then any file attachments in an unordered list below the post text. See [[#Discussion/ReplyStructure|Mockup: Discussion/Reply Structure]]
# If there are no actions the user can perform on the post then the action area and menu will not display
# When the forum is set to separate groups and a discussion is set to all participants the action area and action menu will not display to students.
# Replies in the discussion pane will display based on the reply hierarchy and depth.
# If the teacher is the creator of the discussion or reply their name will be denoted in bold and the screen reader will read “Teacher” before reading the poster’s name.
# Anywhere in the below action menus if the action is subscribe it will be replaced with unsubscribe if the user is already subscribed to the discussion.
# Anywhere in the below action menus if the action bookmark is available the option remove bookmark will show if the discussion or reply is already bookmarked
# Anywhere in the below action menus if the action mark substantive is available the option Unmark substantive will show if the discussion or reply is already marked as substantive.
# Reply will display in the below action menus only if the user has permissions to create a reply
# Rating and view ratings will only display in the action menus if the rating setting is enabled for the forum.
# A teacher will have the following actions available when viewing their own discussion: (See [[#TeacherViewsOwnDiscussion|Mockup: Teacher Views Own Discussion]])
## Edit
## Delete
## View ratings (only displays if ratings are enabled for the forum)
## Subscribe (will not display if subscribed to the forum or forum subscription is disabled)
## Mark substantive
## Bookmark
## Reply
# A teacher will have the following actions available when viewing their own reply: (See [[#TeacherViewsTeacherReply|Mockup: Teacher Views Teacher Reply]])
## Edit
## Split
## Delete
## View ratings (only displays if ratings are enabled for the forum)
## Mark substantive
## Bookmark
## Reply
# A teacher will have the following actions available when viewing a student’s reply: (See [[#TeacherViewsStudentReply|Mockup: Teacher Views Student Reply]])
## Reply
## Split
## Delete
## Rate (only displays if ratings are enabled for the forum)
## Mark substantive
## Bookmark
# A student will have the following actions available when viewing a discussion: (See [[#StudentViewsDiscussion|Mockup: Student Views Discussion]])
## Reply
## Rate
## Subscribe
# A student will have the following actions available when viewing their own reply: (See [[#StudentViewsOwnReply|Mockup: Student Views Own Reply]])
## Edit
## Delete
## Reply
# A private reply will display only to the student who created the original reply and the teachers.
# A teacher will have the following options available when viewing a private reply: (See [[#TeacherViewPrivateReply|Mockup: Teacher View Private Reply]])
## Edit
## Split
## Delete
# The action area and menu will not display to a student for a private reply.
# The user’s picture will display as the default user picture for an anonymous forum. See ([[#AnonymousReply|Mockup: Anonymous Reply]])
# The user’s name will appear as a Anonymous user instead of the creators real name.
# A user will have all the same action menu menu items for an anonymous reply as they would for a reply of the same type in a regular forum.
# A user will be able to use the spacebar to open the action menu
# A user will be able to use the tab key to navigate to a post’s action menu
# A user will be able to use the enter key to select an action menu item.
# Selecting the reply action will bring up the reply form below the post the user is replying to.
# The student reply modal will have the fields in [[#StudentReplyFormInline|Mockup: Student Reply Form Inline]]
# The file upload area will not display if the forum is set to not allow attachments.
# The teacher reply form will have the following additional form fields compared to a student’s reply form based on the type of forum and the forum settings: See ([[#TeacherReplyFormInline|Mockup: Teacher Reply Form Inline]])
## Mail now
## Group (select box with available groups if the forum is set to visible or separate groups)
## Private reply
## Reveal yourself in this post (if the forum is set to anonymous)
# Clicking the ''Post to forum'' button in the reply form will cause the following things to happen:
## The reply is added as the last reply to the post the user selected reply for
## The discussion tree view is updated to reflect the added reply if the parent post is expanded
## The user’s browser focus is placed on the header of the newly created reply.
# Clicking the ''Cancel'' button in the reply form will cause the following things to happen:
## The reply form stops displaying inline below the current post
## The user’s browser focus is placed on the header of the post the user was replying to.
# Selecting the split action will bring up the split post modal. See ([[#SplitPostModal|Mockup: Split Post Modal]])
# The split post modal will key the keyboard locked in the modal until the user clicks the ''Close'', ''Cancel'', or ''Split'' button.
# Clicking the ''Split'' button in the split modal will cause the following things to happen:
## The Split post modal to close
## The post converted to the initial discussion post for the new discussion with the title in the new discussion title field of the modal
## The reply hierarchy for the post are still associated with the post
## The discussion display pane will display the new discussion that the post was split into.
## The user’s browser focus is placed on the header for the initial post of the new discussion
## The discussion tree in the forum and discussion pane is updated to reflect the changes to the forum hierarchy
# Selecting the delete action will bring up a conformation that the user wants to delete the reply or discussion. See ([[#DeleteReplyModal|Mockup: Delete Reply Modal]])
# Clicking the ''Delete post'' button in the delete post modal will do the following things:
## Close the modal
## Remove the post and the reply in the hierarchy attached to the post and lower.
## Add a message to the message output stating “The <post header> was successfully deleted”.
## The user’s browser focus will be placed on the success message.
# The delete post modal will keep the keyboard locked in the modal until the user clicks the ''Close'', ''Cancel'', or ''Delete post'' button.
# Selecting the edit action will bring up the reply form inline pre-populated with the post that is being edited. See ([[#EditReplyForumInline|Mockup: Edit Reply Form Inline]])
# Selecting the rate action will bring up the rate modal pre-populated with the current rating the user has given the post. See [[#RatingModal|Mockup: Rating Modal]]
# The rate post modal will key the keyboard locked in the modal until the user clicks the ''Close'', ''Cancel'', or ''Rate post'' button.
# Clicking the ''Rate'' button in the rate modal will cause the following things to happen:
## The rate post modal will close
## The rating the user had entered will be saved for the post
## The rating for the post will update based on the forum settings.
## A message will be added the message output area stating “The rating was successfully saved” with a link to jump back to the post within the discussion display panel.
# Selecting the view ratings action will bring up the view ratings modal. See ([[#ViewRatingsModal|Mockup: View Ratings Modal]])
# The view ratings modal will keep the user’s keyboard focus until the user clicking on the ''Close'' or ''Close this window'' button.
# Closing a modal using the ''Close'', ''Close this window'' or ''Cancel'' buttons will place the user’s browser focus back on the action menu the user was on when they opened the modal.
# Any errors in the processing of a modal will display an error message in the message output area with a link back to the area the user was in when the error occurred.
# Selecting the ''Subscribe'' action will do the following things:
## Subscribe the user to the discussion to receive emails when new replies are created in the discussion
## Display a message in the message output stating that the user has been subscribed to the discussion
## Place the user’s browser focus on the message output.
# Selecting the ''Unsubscribe'' action will do the following things:
## Unsubscribe the user from the discussion and cause the user to stop receiving emails when new replies are created in the discussion
## Display a message in the message output stating that the user has been unsubscribed to the discussion
## Place the user’s browser focus on the message output.
# Selecting the ''Bookmark'' action will do the following things:
## Add the bookmark flag to the post
## Display a message in the message output stating that the post was bookmarked
## The message will end with a link to jump to the post that was bookmarked.
## Place the user’s browser focus on the message output
# Selecting the ''Remove bookmark'' action will do the following things:
## Remove the bookmark flag from the post
## Display a message in the message output stating that the bookmark has been removed from the post
## The message will end with a link to jump to the post that the bookmark was removed from.
## Place the user’s browser focus on the message output
## The message will end with a link to jump to the post that the bookmark was removed from.
# Selecting the ''Mark substantive'' action will do the following things:
## Add the substantive flag to the post
## Display a message in the message output stating that the post was flagged as substantive
## The message will end with a link to jump to the post that was flagged as substantive
## Place the user’s browser focus on the message output
# Selecting the ''Unmark substantive'' mark_ action will do the following things:
## Remove the substantive flag from the post
## Display a message in the message output stating that the substantive flag was removed from the post
## The message will end with a link to jump to the post the substantive flag was removed from.
## Place the user’s browser focus on the message output

===== Mockups =====

====== Discussion Display Pane Structure ======

[[Image:afDiscussionDisplayPaneStructure.png|afDiscussionDisplayPaneStructure.png]]

====== Discussion/Reply Structure ======

[[Image:afReplyStructure.png|afReplyStructure.png]]

====== Teacher Views Own Discussion ======

[[Image:afTeacherViewOwnDiscussion.png|afTeacherViewOwnDiscussion.png]]

====== Teacher Views Teacher Reply ======

[[Image:afTeacherViewTeacherReply.png|afTeacherViewTeacherReply.png]]

====== Teacher Views Student Reply ======

[[Image:afTeacherViewStudentReply.png|afTeacherViewStudentReply.png]]

====== Student Views Discussion ======

[[Image:afStudentViewDiscussion.png|afStudentViewDiscussion.png]]

====== Student Views Own Reply ======

[[Image:afStudentViewOwnReply.png|afStudentViewOwnReply.png]]

====== Teacher View Private Reply ======

[[Image:afPrivateReply.png|afPrivateReply.png]]

====== Anonymous Reply ======

[[Image:afAnonymousReply.png|afAnonymousReply.png]]

====== Student Reply Form Inline ======

[[Image:afStudentReplyModal.png|afStudentReplyModal.png]]

====== Teacher Reply Form Inline ======

[[Image:afTeacherReplyModal.png|afTeacherReplyModal.png]]

====== Rating Modal ======

[[Image:afRatingModal.png|afRatingModal.png]]

====== Split Post Modal ======

[[Image:afSplitModal.png|afSplitModal.png]]

====== Delete Post Modal ======

[[Image:afDeletePostModal.png|afDeletePostModal.png]]

====== Edit Reply Form Inline ======

[[Image:afEditModal.png|afEditModal.png]]

====== View Ratings Modal ======

[[Image:afViewRatingsModal.png|afViewRatingsModal.png]]

===== Use Cases =====

====== Student Listens to a Discussion Created by a Teacher ======

'''Description'''

A student selects a discussion using a screen reader and keyboard and listens to the screen reader read the discussion post.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the forum
# The student is using a screen reader
# The student has set the accessible forum display
# More than one discussion has been created by the teacher
# Replies have been posted to discussions

'''Steps'''

# The student uses the F6 key to get to the filter pane
# The student uses the F6 key to get to the forum and discussion pane
# The student uses the enter key to select the discussion

'''Postconditions'''

# The student is able to identify that the teacher created the discussion and not just another student.

====== Student Navigates Between Replies to a Discussion Using a Keyboard ======

'''Description'''

A student navigates between reply headings using the screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the forum
# The student is using a screen reader
# The student has set the accessible forum display
# More than one discussion has been created by the teacher
# The student has made a reply to a discussion

'''Steps'''

# The student uses the F6 key to get to the filter pane
# The student uses the F6 key to get to the forum and discussion pane
# The student uses the enter key to select the discussion
# The student uses the screen readers next header function to locate the next reply

'''Postconditions'''

# The student can identify by the header where they are within the forum hierarchy.
# The student is able to quickly navigate to each reply

====== Student Replies to a Discussion Using a Keyboard ======

'''Description'''

A student creates a reply to a discussion using a screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the forum
# The student is using a screen reader
# The student has set the accessible forum display
# More than one discussion has been created by the teacher
# Replies have been posted to discussions

'''Steps'''

# The student uses the F6 key to get to the filter pane
# The student uses the F6 key to get to the forum and discussion pane
# The student uses the enter key to select the discussion
# The student hits the tab key to tab to the action menu for the discussion
# The student hits the spacebar to open the action menu
# The student uses the down arrow to navigate to the reply action
# The student hits the enter key
# The student uses the tab key to tab through the forum fields and enter a reply
# The student tabs to the ''Post to forum'' button
# The student hits the enter key

'''Postconditions'''

# The reply is added to the discussion display pane in the proper place
# The student hears the header of the new reply

====== Student Edits a Reply Using a Keyboard ======

'''Description'''

A student edits a reply they have made using a screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the forum
# The student is using a screen reader
# The student has set the accessible forum display
# More than one discussion has been created by the teacher
# The student has made a reply to a discussion

'''Steps'''

# The student uses the F6 key to get to the filter pane
# The student uses the F6 key to get to the forum and discussion pane
# The student uses the enter key to select the discussion
# The student uses the screen readers next header keyboard commands to locate the reply they want to edit.
# The student hits the tab key to tab to the action menu for the discussion
# The student uses the spacebar to open the action menu
# The student uses the down arrow to select the edit menu item
# The student uses the enter key to select the edit menu item
# The student uses the tab key to navigate to the field they want to change
# The student uses the tab key to navigate to the ''Post to forum'' button
# The student hits the enter key to post the edits to the forum

'''Postconditions'''

# The reply is updated in the discussion display pane in the proper place
# The student hears the header of the edited reply

====== Student Subscribes to a Discussion Using a Keyboard ======

'''Description'''

A student subscribes to a discussion using a screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the forum
# The student is using a screen reader
# The student has set the accessible forum display
# More than one discussion has been created by the teacher
# The forum is set to optional forum subscriptions.
# The student is not subscribed to the forum
# The student has not subscribed to the discussion

'''Steps'''

# The student uses the F6 key to get to the filter pane
# The student uses the F6 key to get to the forum and discussion pane
# The student uses the enter key to select the discussion
# The student uses the screen readers next header keyboard commands to locate the reply they want to subscribe to.
# The student hits the tab key to tab to the action menu for the discussion
# The student uses the spacebar to open the action menu
# The student uses the down arrow to select the subscribe menu item
# The student uses the enter key to select the subscribe menu item

'''Postconditions'''

# The student is subscribed to the discussion
# A message is displayed in the message output area stating that the student has been subscribed to the discussion.
# The student hears the message

====== Student Accesses a Discussion’s Action Menu Using a Mouse ======

'''Description'''

A student displays a discussion’s action menu using a mouse.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the forum
# The student is using a screen reader
# The student has set the accessible forum display
# More than one discussion has been created by the teacher

'''Steps'''

# The student clicks on the discussion
# The student clicks on the action menu for the discussion

'''Postconditions'''

# The action menu expands

====== Teacher Rates a Post Using a Keyboard ======

'''Description'''

A teacher rates a student’s post using a screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a teacher
# An advanced forum has been created in the course
# The teacher has navigated to the course
# The teacher is using a screen reader
# The teacher has set the accessible forum display
# The teacher has created a discussion
# A student has made a reply to a discussion
# The forum is set to allow rating
# The student reply has not been rated

'''Steps'''

# The teacher uses the F6 key to get to the filter pane
# The teacher uses the F6 key to get to the forum and discussion pane
# The teacher uses the enter key to select the discussion
# The teacher uses the screen readers next header keyboard commands to locate the reply they want to rate.
# The teacher hits the tab key to tab to the action menu for the discussion
# The teacher uses the spacebar to open the action menu
# The teacher uses the down arrow to select the rate menu item
# The teacher uses the enter key to select the rate menu item
# The teacher uses the spacebar to open the rating select box
# The teacher uses the down arrow to select the rating they want.
# The teacher hits the enter key to select the rating for the post
# The teacher uses the tab key to navigate to the rate button.
# The teacher uses the enter key to rate the post.

'''Postconditions'''

# The post is rated
# The post’s rating is recalculated
# A message is displayed in the message output area stating that the post has been rated and allowing the teacher to jump to the post they rated.
# The student hears the message

====== Teacher Deletes a Discussion Using a Keyboard ======

'''Description'''

A teacher deletes a discussion using a screen reader and keyboard

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a teacher
# An advanced forum has been created in the course
# The teacher has navigated to the course
# The teacher is using a screen reader
# The teacher has set the accessible forum display
# A discussion has been created in the forum
# A reply has been made to the discussion

'''Steps'''

# The teacher uses the F6 key to get to the filter pane
# The teacher uses the F6 key to get to the forum and discussion pane
# The teacher uses the enter key to select the discussion
# The teacher hits the tab key to tab to the action menu for the discussion
# The teacher uses the spacebar to open the action menu
# The teacher uses the down arrow to select the delete menu item
# The teacher uses the enter key to select the delete menu item
# The teacher uses the spacebar to open the delete select box
# The teacher listens to the modal window text
# The teacher uses the tab key to navigate to the delete post button.
# The teacher uses the enter key to delete post button to delete the post.

'''Postconditions'''

# The post is deleted
# A message is displayed in the message output area stating that the post has been deleted and allowing the teacher to jump back to the forum and discussion pane
# The student hears the message

====== Teacher the Views Ratings for a Post Using a Keyboard ======

'''Description'''

A teacher views the ratings that have been given for a student’s post using a screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a teacher
# An advanced forum has been created in the course
# The teacher has navigated to the course
# The teacher is using a screen reader
# The teacher has set the accessible forum display
# The teacher has created a discussion
# A student has made a reply to a discussion
# The teacher and others have rated a student’s reply

'''Steps'''

# The teacher uses the F6 key to get to the filter pane
# The teacher uses the F6 key to get to the forum and discussion pane
# The teacher uses the enter key to select the discussion
# The teacher uses the screen readers next header keyboard commands to locate the reply they want to view the ratings for.
# The teacher hits the tab key to tab to the action menu for the discussion
# The teacher uses the spacebar to open the action menu
# The teacher uses the down arrow to select the view ratings menu item
# The teacher uses the enter key to select the view ratings menu item

'''Postconditions'''

# The view ratings modal appears with all the ratings that have been submitted for the post.

====== Teacher Splits a Reply Using a Keyboard ======

'''Description'''

A teacher splits a reply into a new discussion using a screen reader and keyboard

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a teacher
# An advanced forum has been created in the course
# The teacher has navigated to the course
# The teacher is using a screen reader
# The teacher has set the accessible forum display
# The teacher has created a discussion
# The reply has multiple replies to it.

'''Steps'''

# The teacher uses the F6 key to get to the filter pane
# The teacher uses the F6 key to get to the forum and discussion pane
# The teacher uses the enter key to select the discussion
# The teacher uses the screen readers next header keyboard commands to locate the reply they want to split.
# The teacher hits the tab key to tab to the action menu for the discussion
# The teacher uses the spacebar to open the action menu
# The teacher uses the down arrow to select the split menu item
# The teacher uses the enter key to select the split menu item
# The teacher uses the tab key to tab to the new discussion title field and enters a discussion title
# The teacher tabs to the split button
# The teacher hits the enter key to split the reply

'''Postconditions'''

# A new discussion is created from the reply with the title provided in the new discussion title field
# A message appears in the message output area that states the reply was split.
# The teacher’s browser focus is set to the message output
# The discussion display pane shows the newly created discussion
# The discussion tree in the forum and discussion pane is updated with the new discussion.

====== Teacher Marks a Post as Substantive Using a Keyboard ======

'''Description'''

A teacher marks a post as substantive using a screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a teacher
# An advanced forum has been created in the course
# The teacher has navigated to the course
# The teacher is using a screen reader
# The teacher has set the accessible forum display
# The teacher has created a discussion
# A student has made a reply to a discussion

'''Steps'''

# The teacher uses the F6 key to get to the filter pane
# The teacher uses the F6 key to get to the forum and discussion pane
# The teacher uses the enter key to select the discussion
# The teacher uses the screen readers next header keyboard commands to locate the reply they want mark as substantive.
# The teacher hits the tab key to tab to the action menu for the discussion
# The teacher uses the spacebar to open the action menu
# The teacher uses the down arrow to select the mark substantive menu item
# The teacher uses the enter key to select the mark substantive menu item

'''Postconditions'''

# The post is marked as substantive
# A message is added to the message output area stating that the post has been marked substantive and a link is included to allow the teacher to jump to the post.
# The teacher’s browser focus is placed on the message output.
# The teacher hears the message read to them.

====== Teacher Bookmarks a Post Using a Keyboard ======

'''Description'''

A teacher bookmarks a post using a screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a teacher
# An advanced forum has been created in the course
# The teacher has navigated to the course
# The teacher is using a screen reader
# The teacher has set the accessible forum display
# The teacher has created a discussion
# A student has made a reply to a discussion

'''Steps'''

# The teacher uses the F6 key to get to the filter pane
# The teacher uses the F6 key to get to the forum and discussion pane
# The teacher uses the enter key to select the discussion
# The teacher uses the screen readers next header keyboard commands to locate the reply they want to view the ratings for.
# The teacher hits the tab key to tab to the action menu for the discussion
# The teacher uses the spacebar to open the action menu
# The teacher uses the down arrow to select the bookmark menu item
# The teacher uses the enter key to select the bookmark menu item

'''Postconditions'''

# The post is flagged as bookmarked
# A message is added to the message output area stating that the post has been bookmarked and a link is included to allow the teacher to jump to the post.
# The teacher’s browser focus is placed on the message output.
# The teacher hears the message read to them.

=== Glossary ===

* '''Reply depth:''' The hierarchical level that a reply is on. A reply to a discussion is reply depth 1. A reply to a reply is depth 2. A reply to a reply to a reply is depth 3. Example: Discussion (depth 0) Reply (depth 1) Reply 2 (depth 2) Replay 3 (depth 3) Reply 4 (depth 2) Replay 5 (depth 1)

=== Document Change Management ===

==== Revision Summary ====

# Switched from a reply modal to an inline reply form to allow the user to navigate back up in the discussion hierarchy to listen to the post they are replying to.

==== Revision History ====

# Jason Hardin 20130812: Updated the specification to remove the reply modals and replace the references with inline forms. Updated some language to make the requirements make more sense.

=== Open Questions ===

# Is the breadcrumb required in Moodle for the forum?
# Does the breadcrumb need to be dynamically updated based on the user’s selection in the discussion tree?

Advanced Forums Accessible Display Specification

2013-07-25T00:33:27Z

Psychoph:

=== Visioning ===

==== Overview ====

The Moodle forums is not as accessible as it could be. In order to improve usability of forums for those with disabilities Moodlerooms is will enhance advanced forums to display discussions based on EASI: Equal Access to Software & Information’s accessible forum design.

==== Business Goals ====

# Progress towards NFB Certification
# Keep strategic clients
# Improve sales for prospects with high accessibility requirements.

==== Product Goals ====

# Increase the accessibility of forum discussion display
# Increase usability of forums

==== Business References ====

* University of Montana (UofM)
* National Federation of the Blind (NFB)
* Department of Education

=== Scenarios ===

==== Administrator Sets Advanced Forums as the Forums for All Forums on a Site ====

The administrator needs to force all forums to be created as advanced forums to meet the institutions accessibility policy. To do this the administrator sets all news forums to be created as advanced forums and disabled each roles capabilities to create forums.

==== Teacher Restricts Number of Replies ====

In order to keep forum conversations on topic the student wants to keep the depth of replies to a minimal. After a number of replies to replies a user will not be able to create a reply to a reply.

==== A Visually Impaired Student Listens to Posts in a Course Forum ====

A student needs to review the new posts that students and students have posted to their course forums. Using a screen reader the student accesses the forum and listens to the replies that have been made in the forum.

==== A Visually Impaired Student Replies to a Post in a Course Forum ====

A student wants to reply to a discussion made by the student. Using a screen reader the student navigates to the discussion and hits return when they find the reply link. The student is then placed in a text editor to create their reply. The student then saves the reply by navigating to the post button.

==== A Visually Impaired Student Sorts Forum Discussions ====

A student wants to sort the discussions by which have the newest posts in order to understand what the latest changes are to the forum. The student navigates to the sort using a screen reader and hits enter when they have found the sort by newest post.

=== References ===

==== Jira ====

==== Technical ====

* [http://easi.cc/archive/bb2013/recording/index.htm Recording of a discussion on the accessible prototype (EASI)]
* [https://dl.dropboxusercontent.com/u/137779786/discussion_module_mockup/discussion_board-listview.html Prototype of an accessible forum (ESAI) ]
* [http://www.oaa-accessibility.org/examples/ OpenAjax Accessibility examples]
* [http://webaim.org/techniques/keyboard/accesskey WebAIM on keyboard shortcuts]

=== Feature Information ===

==== Advanced Forums Site Settings ====

===== Description =====

Advanced forums will allow administrators to set the default forum display (renamed from discussion display) for all users. Advanced forums will also allow a site administrator to set the default maximum reply depth.

===== Requirements =====

# Rename Discussion display to Forum display in advanced forums display types.
# A new checkbox administrative settings called Create news forums as advanced forums will be added to the activity’s administrative settings page. See [[#AdvancedForumAdministrativeSettings|Mockup: Advanced Forum Administrative Settings]]
# The default value for the Create news forums as advanced forums is unchecked aka no.
# A new select box administrative settings called Default forum display will be added to the activity’s administrative settings page. See [[#AdvancedForumAdministrativeSettings|Mockup: Advanced Forum Administrative Settings]]
# The default value for the Default forum display is default
# The possible values for the Default forum display will be:
## Accessible
## Default
## Nested
## Tree
# A new administrative settings called Maximum reply depth will be added to the activity’s administrative settings page. See [[#AdvancedForumAdministrativeSettings|Mockup: Advanced Forum Administrative Settings]]
# The default value for the Maximum reply depth will be 3. See [[#AdvancedForumAdministrativeSettings|Mockup: Advanced Forum Administrative Settings]]

===== Mockups =====

====== Advanced Forum Administrative Settings ======

[[Image:afAdminSettings.png|afAdminSettings.png]]

===== Use Cases =====

====== Administrator Sets Default Forum Display ======

'''Description'''

The administrator sets the default forum display to accessible.

'''Preconditions'''

# The user is logged in
# The user is assigned as a site administrator
# The user is at the site level

'''Steps'''

# The administrator clicks on the ''Plugins'' link group under the Settings block
# The administrator clicks on the ''Activity modules'' link group
# The administrator clicks on the ''Advanced forums'' link
# The administrator selects ''Accessible'' from the ''Default forum display'' select box
# The administrator clicks the ''Save changes'' button

'''Postconditions'''

# the settings are saved

====== Administrator Sets the Site to Create all News Forums as Advanced Forums ======

'''Description'''

The administrator sets the site to use advanced forums for all newly created news forums.

'''Preconditions'''

# The user is logged in
# The user is assigned as a site administrator
# The user is at the site level

'''Steps'''

# The administrator clicks on the ''Plugins'' link group under the Settings block
# The administrator clicks on the ''Activity modules'' link group
# The administrator clicks on the ''Advanced forums'' link
# The administrator clicks the checkbox to the left of Create all new forums as advanced forums
# The administrator clicks the ''Save changes'' button

'''Postconditions'''

# The settings are saved

====== Administrator Sets the Default Maximum Reply Depth ======

'''Description'''

The administrator sets the default maximum reply depth for all newly created forums to be 1.

'''Preconditions'''

# The user is logged in
# The user is assigned as a site administrator
# The user is at the site level

'''Steps'''

# The administrator clicks on the ''Plugins'' link group under the Settings block
# The administrator clicks on the ''Activity modules'' link group
# The administrator clicks on the ''Advanced forums'' link
# The administrator enters 1 in the text box to the right of the Maximum reply depth setting.
# The administrator clicks the ''Save changes'' button

'''Postconditions'''

# The settings are saved.

====== Administrator Creates a Course With an Advanced Forums News Forum ======

'''Description'''

The administrator creates a course with a news forum. The news forum is created as an advanced forum.

'''Preconditions'''

# The user is logged in
# The user is assigned as a site administrator
# The advanced forum setting create news forums as advanced forums is checked.
# The user is at the site level

'''Steps'''

# The administrator clicks the ''Courses'' link group
# The administrator clicks the ''Add/edit courses'' link
# The administrator clicks the ''Add a new course'' button
# The administrator fills out the course information
# The administrator clicks the ''Save changes'' button

'''Postconditions'''

# The news forum created for the course is an advanced forum.

==== Advanced Forum Accessible Settings ====

===== Description =====

A new setting will be added to the create a forum screen that will allow the student to restrict the maximum depth of replies for a discussion.

===== Requirements =====

# A new setting will be added to the create a forum screen under the general group called maximum [[#replydepth|reply depth]]. See [[#AdvancedForumDepthSetting|Mockup: Advanced Forum Depth Setting]]
# The default value for the maximum [[#replydepth|reply depth]] will be 3
# The maximum [[#replydepth|reply depth]] will be 7
# Once the [[#replydepth|reply depth]] in a discussion reaches maximum reply depth the a student will not be able to reply to the reply. See [[#MaximumReplyDepthDisplay|Mockup: Maximum Reply Depth Display]]
# When a teacher creates a reply to the maximum depth reply the reply will be marked automatically as a private reply.
# A teacher will be unable to uncheck the private reply checkbox for a reply to a reply at the maximum reply depth. See [[#TeacherReplytoaMaximumDepthReply|Mockup: Teacher Reply to a Maximum Depth Reply]]

===== Mockups =====

====== Advanced Forum Depth Setting ======

[[Image:afMaxDepthSetting.png|afMaxDepthSetting.png]]

====== Maximum Reply Depth Display ======

[[Image:afMaxReplyDepthDisplay.png|afMaxReplyDepthDisplay.png]]

====== Teacher Reply to a Maximum Depth Reply ======

[[Image:afMaxReplyPrivateReply.png|afMaxReplyPrivateReply.png]]

===== Use Cases =====

====== Teacher Creates a Forum with a Maximum Reply Depth of 2 ======

'''Description'''

The student wants to limit the reply depth to 2 to keep the students on track with the forum discussion.

'''Preconditions'''

# The user is logged in
# The users is assigned the student role in the course
# The user has navigated to the course
# The course is set to weeks or topics format

'''Steps'''

# The student clicks on the add activity link
# The student selects Advanced forum
# The student fills out the forum information
# The student selects one from the select box for maximum reply depth

'''Postconditions'''

# Users cannot reply to a reply or a reply
# The student can still create a private reply to a reply of a reply

====== A Student Views a Reply at the Maximum Reply Depth ======

'''Description'''

A student views a reply that is at the maximum reply depth.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course with a maximum reply depth
# The forum has multiple replies with one at the maximum reply depth
# The student has navigated to the course

'''Steps'''

# The student clicks on the forum
# The student scrolls to the reply at the maximum reply depth

'''Postconditions'''

# The student doesn’t see the reply link.

====== A Teacher Replies to a Maximum Reply Depth Reply ======

'''Description'''

The student wants to create a private reply to the student’s reply even though it is at the maximum reply depth.

'''Preconditions'''

# The user is logged in
# The user is assigned to the student role in a course
# An advanced forum has been created in the course with a maximum reply depth
# The forum has multiple replies with one at the maximum reply depth
# The student has navigated to the course

'''Steps'''

# The student clicks on the forum
# The student scrolls to the reply at the maximum reply depth
# The student clicks on the reply link
# The student fills out the reply form
# The student clicks the ''Post to forum'' button

'''Postconditions'''

# The Private reply checkbox is checked and disabled
# The student can’t change the reply to a non private reply.

==== Private Reply Display ====

===== Description =====

To improve the accessibility of private replies Moodlerooms will add a string to the front of private replies to identify them to the user.

===== Requirements =====

# Private replies will have the string Private reply: added to the front of the title for the reply. See [[#PrivateReplyDisplay|Mockup: Private Reply Display]]
# The string Private reply will be translatable.

===== Mockups =====

====== Private Reply Display ======

[[Image:afPrivateReply.png|afPrivateReply.png]]

===== Use Cases =====

====== Student Views a Private Reply ======

'''Description'''

A student views a private reply from a student in a forum.

'''Preconditions'''

# The user is logged in
# The user is assigned to the student role in a course
# The student has created a reply in a forum
# A student has created a private reply to the student’s reply
# The user has navigated to a course with a private reply in it

'''Steps'''

# The student clicks on the forum
# The student scrolls to view the private reply

'''Postconditions'''

# The string Private reply shows in front of the title for the reply.

==== Accessible Discussion Display ====

===== Description =====

The current display options in advanced forums do not maximize the view for those with disabilities. The accessible discussion display will work to implement the prototype of an accessible forum by ESAI. Users will be able to switch between this discussion display and any other discussion display types.

===== Requirements =====

# A new discussion display mode will be added to the forum display drop down called accessible.
# The accessible forum display will be separated into 5 areas (See [[#AccessibleDisplayStructure|Mockup: Accessible Display Structure]])
## Moodle breadcrumb at the top
## Filter pane at the top
## Forum description (Only shown if set)
## Forum and Discussion selection pane on the left
## Discussion display pane on the right
# Forum management will still be maintained within Moodle’s navigation and settings blocks and accessed via the themes block display.
# The breadcrumb will initially display the full moodle path to the forum the user selected within the course. See [[#NoDiscussionSelected|Mockup: No Discussion Selected]]
# The user will be able to use skip navigation to jump to the forum/discussion pane. See [[#AccessibleDisplayStructure|Mockup: Accessible Display Structure]]
# Navigation from the Discussion display pane to the Forum and Discussion selection pane
# The access key 1 will be used to move to the focus to the Forum select box
# The access key 2 will be used to move the focus to the discussion selection tree view
# The F6 key will be used to to switch focus to the next pane of the filter, forum and discussion and the discussion display panes. See [[#AccessibleDisplayStructure|Mockup: Accessible Display Structure]]
# The Shift+F6 keys will be used to switch focus to the previous pane of the filter, forum and discussion and the discussion display panes. See [[#AccessibleDisplayStructure|Mockup: Accessible Display Structure]]
# When navigating between panes a screen reader will be informed of the region the user has navigated to.

====== Accessible Display Structure ======

[[Image:afAccessibleDisplayStructure.png|afAccessibleDisplayStructure.png]]

====== No Discussion Selected ======

[[Image:afNoDiscussionSelected.png|afNoDiscussionSelected.png]]

===== Use Cases =====

====== Student Selects Accessible Forum Display ======

'''Description'''

A student will a visual disability wants to maximize their usability of advanced forums and selects the accessible forum display type.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course with a maximum reply depth
# The student has navigated to the course
# The student is using a screen reader

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the screen reader to skip to the main content of the page
# The student tabs to the forum display select drop down
# The student uses the space button to open the the select drop down
# The student uses the arrow keys to highlight the accessible select option
# The student hits the enter key

'''Postconditions'''

# The page reloads
# The accessible forum display appears

====== Student Uses F6 to Navigate Between Panes ======

'''Description'''

A visually impaired user wants to quickly change between the panes in the accessible forum view using the F6 key.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student hits the F6 key

'''Postconditions'''

# The student is taken to the filter pane
# The student is informed they are in the filter region

====== Student Uses Shift+F6 to Navigate Between Panes ======

'''Description'''

A student wants to navigate back through the panes of the accessible forum display using the shift+F6 key combination.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student hits the Shift+F6 key combination

'''Postconditions'''

# The student is taken to the discussion display pane
# The student is informed they are in the discussion display region

====== Student Uses Access key 1 to Navigate to the Forum Selection box ======

'''Description'''

A student wants to jump directory to the forum selector to change the forum they are viewing.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student clicks the screen reader’s key combination for the access 1 key

'''Postconditions'''

# The keyboard focus is set of the forum selector box box

====== Student Uses Access key 2 to Navigate to the Discussion Selection Tree view ======

'''Description'''

A student wants to jump to the discussion tree selector to quickly select a new reply to listen to.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student clicks the screen reader’s key combination for the access 2 key

'''Postconditions'''

# The keyboard focus is set of the discussion selector tree view box

==== Accessible Forum Display Filter Pane ====

===== Description =====

In order to quickly access the information users need from the forums they will need to be able to sort and filter the discussions in the forum. Users will also need to be able to change the forum display to their preferred display from the default or current display.

===== Requirements =====

{note}See original [Specs 2.4 Advanced Forums] for how discussions are sorted using each sort by type{note}

# The filter pane will display the following menus based on the forum configuration for the teacher: (See [[#FilterPaneExpandedTeacher|Mockup: Filter Pane Expanded Teacher]])
## Group menu (only displayed if visible or separate groups is set for the forum)
### All participants
### List of all groups in the grouping assigned to the forum.
## Sort by (each menu item will have a sub menu for changing the sort to ascending or descending)
### Last post date
### Creation date
### Last name
### First name
### Number of replies
## Forum display
### Accessible
### Default
### Nested
### Tree
# The filter pane will display the following menus based on the forum configuration for the student: (See [[#FilterPaneExpandedStudent|Mockup: Filter Pane Expanded Student]])
## Sort by (each menu item will have a sub menu for changing the sort to ascending or descending)
### Last post date
### Creation date
### Last name
### First name
### Number of replies
## Forum display
### Accessible
### Default
### Nested
### Tree
# The filter pane will display the simple forum search form for all users. See [[#FilterPane|Mockup: Filter Pane]]
# The user will be able to tab to the first menu and the search field
# The user will use the left and right arrows to switch between menus and to open sub menus
# The user will use the up and down arrows to navigate between menu items
# The user will use the spacebar to open the menu
# Selecting a sort by option will open up the ascending or descending sub menu. See [[#FilterPaneExpandedStudent|Mockup: Filter Pane Expanded Student]]
# Selecting ascending or descending in a sort by submenu will rest the discussion display pane to its default state. See [[#NoDiscussionSelected|Mockup: No Discussion Selected]]
# Selecting ascending or descending in a sort by submenu will rest the page’s Moodle breadcrumb to the path to the current forum. See [[#NoDiscussionSelected|Mockup: No Discussion Selected]]
# Selecting ascending or descending will sort the discussion list based on the sort by and ascending or descending selection.
# Selecting ascending or descending will set the student’s focus to the Discussion tree view.
# If the forum is not set to use groups in the forum settings then the view group menu in the top navigation will not display. See [[#FilterPaneExpandedStudent|Mockup: Filter Pane Expanded Student]]
# Selecting a group in the view group selector will change the discussion pane to display only discussions for that group and all participants.
# Selecting a group in the view group selector will focus the user on the Discussion tree view
# Selecting a group will reset the discussion view pane to its default state of no discussion or reply being displayed. See [[#NoDiscussionSelected|Mockup: No Discussion Selected]]
# Selecting a group will reset the Moodle breadcrumb to the path to the current forum. See [[#NoDiscussionSelected|Mockup: No Discussion Selected]]
# Selecting a display type in the forum display menu will cause the page to reload and the new forum display to display the forum. See [[#NoDiscussionSelected|Mockup: No Discussion Selected]]
# Clicking the ''Search'' button will bring up the search results in the discussion display pane. See [[#SearchResults|Mockup: Search Results]]
# The search one the filter pane will search only the current forum.
# Clicking the ''Advanced search'' button will display the Advanced search modal. See [[#AdvancedSearchModal|Mockup: Advanced Search Modal]]
# The advanced search modal will lock the user’s keyboard in the modal until the user click the ''Close'', ''Cancel'', or ''Search forums'' button.
# Clicking the ''Search'' button on the filter pane or the ''Search forums'' button in the advanced search modal will display the search results in the discussion display pane. See [[#SearchResults|Mockup: Search Results]]
# The user’s browser focus will be placed on the discussion display pane after a search has finished.
# The search results will display the same as described in the [[#AccessibleForumDiscussionDisplayPane|Section: Accessible Forum Discussion Display Pane]] with a header titled Search results with a count of the number of posts found.
# The action menu for each post in the search results will consist of the following links: (See [[#SearchResults|Mockup: Search Results]])
## Show post in full discussion
## Show post and its replies
# Selecting Show post in full discussion in the action menu will cause the following to happen:
## The discussion display pane will display all posts in the discussion the post is in.
## The user’s browser focus will be placed on the post in the discussion display pane
# Selecting Show post and its replies in the action menu will cause the following to happen:
## The discussion display pane display the post and all replies to the post in the discussion hierarchy.
## The user’s browser focus will be placed on the post in the discussion display pane

===== Mockups =====

====== Filter Pane ======

[[Image:afFilterPane.png|afFilterPane.png]]

====== Filter Pane Expanded Teacher ======

[[Image:afFilterPaneExpandedTeacher.png|afFilterPaneExpandedTeacher.png]]

====== Filter Pane Expanded Student ======

[[Image:afFilterPaneExpandedStudent.png|afFilterPaneExpandedStudent.png]]

====== Search Results ======

[[Image:afSearchResults.png|afSearchResults.png]]

====== Advanced Search Modal ======

[[Image:afAdvancedSearchModal.png|afAdvancedSearchModal.png]]

===== Use Cases =====

====== Student Accesses the Sort by Menu Using a Keyboard ======

'''Description'''

A student accesses the sort by menu drop down using a screen reader and their keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the screen reader to jump to the main content
# The student uses the tab key to tab to the sort by menu

'''Postconditions'''

# Using the tab key the student is able to find the sort by menu
# The student is able to identify using the screen reader which menu they are on.

====== Student Accesses the Search Field Using a Keyboard ======

'''Description'''

A student accesses the search input field using a screen reader and their keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the screen reader to jump to the main content
# The student uses the tab key to tab to the search input field

'''Postconditions'''

# The student is able to identify that entering text in the field will search to forum for posts with that information in it.
# The student is able to identify they are in a form and need to tab to the ''Search forum'' button

====== Student Opens Sort By Menu Using a Keyboard ======

'''Description'''

A student opens the sort by menu using a screen reader and their keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the screen reader to jump to the main content
# The student uses the tab key to tab to the sort by menu
# The student uses the spacebar to open the sort by menu

'''Postconditions'''

# The sort by menu opens for the student
# The screen reader reads all of the sort by menu items.

====== Student Selects Sort By Number of Replies Descending Using a Keyboard ======

'''Description'''

A student selects sort by number or replies in a descending order using a screen reader and their keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display
# The advanced forum has more than 1 discussion and reply

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the screen reader to jump to the main content
# The student uses the tab key to tab to the sort by menu
# The student uses the spacebar to open the sort by menu
# The student uses the down arrow key to locate the ''Number of replies'' menu item
# The student uses the right arrow key to open the ''Number of replies'' sub menu
# The student uses the down arrow key to select the ''Descending'' menu item

'''Postconditions'''

# The discussion list is resorted by number of replies in a descending order
# The student’s browser focus is set to the discussion tree view
# The student is able to understand via the screen reader that they are not accessing the discussion tree view.

====== Student Navigates Between Menus Using a Keyboard ======

'''Description'''

A student accesses each menu using a keyboard and screen reader.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the screen reader to jump to the main content
# The student uses the tab key to tab to the sort by menu
# The student uses the left arrow key to navigate to the forum display menu

'''Postconditions'''

# The student is able to navigate to the forum display using the keyboard

====== Student Selects a Display Type Using a Keyboard ======

'''Description'''

A student changes the display type from accessible to default using a screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the screen reader to jump to the main content
# The student uses the tab key to tab to the sort by menu
# The student uses the left arrow key to navigate to the forum display menu
# The student uses the spacebar to open the forum display menu
# The student uses the down arrow key to select a new forum display type

'''Postconditions'''

# The student is able to navigate to the forum display using the keyboard
# The page is reloaded and the forum is displayed using the new forum display type

====== Teacher Selects a Group Using a Keyboard ======

'''Description'''

A student filters the lists of discussions by group using a screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display
# The advanced forum is setup to have separate groups
# Students are assigned to groups
# The forum has posts to each group as well as all participants.

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the screen reader to jump to the main content
# The student uses the tab key to tab to the sort by menu
# The student uses the left arrow key to navigate to the view group menu
# The student uses the spacebar to open the view group menu
# The student uses the down arrow key to select a group to view

'''Postconditions'''

# The discussion tree view is updated with the discussions available to the selected group and all participants
# The student’s browser focus is set to the discussion tree view.

====== Student Searches the Forum Using a Keyboard ======

'''Description'''

A student uses a screen reader and keyboard to access the search input field in the filter pane and search the forum.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display
# There are discussion in the forum
# There are replies in the forum
# There are replies or discussions that match the search criteria in the forum.

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the F6 key to navigate to the filter pane
# The student tabs to the search input field
# The student enters their search text in the search input field
# The student tabs to the search button
# The student hits the enter key to search the forums

'''Postconditions'''

# The posts that are found matching the search criteria display in the discussion display pane
# The user’s browser focus is set to the discussion display pane.

====== Student Uses the Advanced Search to Search the Forum Using a Keyboard ======

'''Description'''

A student search the forum using the advanced search modal, a screen reader and a keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display
# There are discussion in the forum
# There are replies in the forum
# There are replies or discussions that match the search criteria in the forum.

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the F6 key to navigate to the filter pane
# The student tabs to the advanced search button
# The student hits the enter key
# The student uses the tab key to fill out the search criteria
# The student tabs to the search forum button
# The student hits enter to search the forum

'''Postconditions'''

# The posts that are found matching the search criteria display in the discussion display pane
# The user’s browser focus is set to the discussion display pane.

====== Student Displays the Discussion the Search Result is a Part of Using a Keyboard ======

'''Description'''

A student selects the to view the discussion that a search result post is a part of using a screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display
# There are discussion in the forum
# There are replies in the forum
# There are replies or discussions that match the search criteria in the forum.
# The user has finished searching via advanced search or simple search.

'''Steps'''

# The student uses the screen readers next header keyboard commands to locate the reply they want to edit.
# The student hits the tab key to tab to the action menu for the discussion
# The student uses the spacebar to open the action menu
# The student uses the down arrow to select the Show post in full discussion menu item
# The student uses the enter key to select the Show post in full discussion menu item

'''Postconditions'''

# The discussion pane displays the discussion that the post is in
# The user’s bowser focus is set to the post that Show post in full discussion was selected for.

====== Student Displays the Search Result and All Replies Using a Keyboard ======

'''Description'''

A student selects to display the search result post and all of its replies using a screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display
# There are discussion in the forum
# There are replies in the forum
# There are replies or discussions that match the search criteria in the forum.
# The user has finished searching via advanced search or simple search.

'''Steps'''

# The student uses the screen readers next header keyboard commands to locate the reply they want to edit.
# The student hits the tab key to tab to the action menu for the discussion
# The student uses the spacebar to open the action menu
# The student uses the down arrow to select the Show post and its replies menu item
# The student uses the enter key to select the Show post and its replies menu item

'''Postconditions'''

# The discussion pane displays the post and all of its sub replies
# The user’s bowser focus is set to the post that Show post and its replies was selected for.

==== Accessible Forum Display Forum and Discussion Pane ====

===== Description =====

The forum and discussion pane is designed to provide the user with quick access to overall activity within the forum. This is where the user quickly navigates to the discussion or reply they want to view in the discussion pane.

===== Requirements =====

# The Forum and discussion pane will display the following: (See [[#ForumandDiscussionPane|Mockup: Forum and Discussion Pane]])
## A drop down list of all forums in the course with the current forum selected
## A button to ''Add a new discussion topic''
## If visible or separate groups is set for the forum a statement of the setting will display below the forum select box. See [[#ForumandDiscussionPaneSeparateGroups|Mockup: Forum and Discussion Pane Separate Groups]] and [[#ForumandDiscussionPaneVisibleGroups|Mockup: Forum and Discussion Pane Visible Groups]]
## An expandable collapsable list of all discussions and replies in the currently selected forum the user can view.
# The forum selector drop down will not appear if there is only one forum in the course
# The forum selector will list all advanced forums in the course in alphabetical order
# Selecting a forum from the forum drop down will reload the page as if the user had clicked on the forum in the course.
# The ''Add a new discussion topic'' button will not appear for users if they do not have permissions to create a discussion.
# Clicking the ''Add a new discussion topic'' will display the ''Your new discussion topic'' modal. See [[#NewDiscussionTopicModal|Mockup: New Discussion Topic Modal]]
# Clicking the ''Post to forum'' button in the ''Your new discussion topic'' modal cause the following to happen:
## Save the discussion to the forum
## Add the discussion in the correct sort order to the discussion tree
## Place the browser focus on the discussion tree.
# The ''Your new discussion topic'' modal will lock the user’s focus in the modal
# Clicking the ''Close'' image will close the modal and the user’s focus will return to the forum and discussion pane.
# Clicking the ''Cancel'' button will close the modal and the user’s focus will return to the forum and discussion pane.
# The user will use tab to navigate between the forum selector, add a new discussion topic button and discussion tree.
# A group selector option will display below the mail now form field if a forum is set to separate or visible groups.
# The user will use the up and down arrows to navigate up and down in the discussion tree. See [[#ForumandDiscussionPaneExpanded|Mockup: Forum and Discussion Pane Expanded]]
# The user will use the left and right arrows to expand and contract the discussion tree. See [[#ForumandDiscussionPaneExpanded|Mockup: Forum and Discussion Pane Expanded]]
# The user will be able to use the mouse to click on the + and - images to expand and contract discussions and replies. See [[#ForumandDiscussionPaneExpanded|Mockup: Forum and Discussion Pane Expanded]]
# Discussions that are collapsed and have replies will have a + image to the left of the discussion title and the screen reader will read that the discussion is collapsed. See [[#ForumandDiscussionPaneExpanded|Mockup: Forum and Discussion Pane Expanded]]
# Replies that are collapsed and have replies will have a + image to the left of the reply title and the screen reader will read that the reply is collapsed. See [[#ForumandDiscussionPaneExpanded|Mockup: Forum and Discussion Pane Expanded]]
# Discussions that are expanded and have replies will have a - image to the left of the discussion title and the screen reader will read that the discussion is expanded. See [[#ForumandDiscussionPaneExpanded|Mockup: Forum and Discussion Pane Expanded]]
# Replies that are expanded and have replies will have a - image to the left of the reply title and the screen reader will read that the reply is expanded. See [[#ForumandDiscussionPaneExpanded|Mockup: Forum and Discussion Pane Expanded]]
# When expanded a discussion or reply will display all replies to the discussion in tree form below it. See [[#ForumandDiscussionPaneExpanded|Mockup: Forum and Discussion Pane Expanded]]
# If a discussion or reply has no replies to it then no image will display to the left of the title. See [[#ForumandDiscussionPaneExpanded|Mockup: Forum and Discussion Pane Expanded]]
# Users will use the enter key on a discussion to display the discussion and all replies in the discussion pane. See [[#DiscussionAccessibleDisplay|Mockup: Discussion Accessible Display]]
# Users will click on a discussion to display the discussion and all replies in the discussion pane. See [[#DiscussionAccessibleDisplay|Mockup: Discussion Accessible Display]]
# Users will use the enter key on a reply to display the reply and all replies to the reply in the discussion pane. See [[#SelectedReplyAccessibleDisplay|Mockup: Selected Reply Accessible Display]]
# Users will click on a reply to display the replies and all replies to the reply in the discussion pane. See [[#SelectedReplyAccessibleDisplay|Mockup: Selected Reply Accessible Display]]
# Clicking on a reply or discussion will place the user’s browser focus on the discussion pane
# Hitting the enter key on a discussion or reply link will place the user’s browser focus on the discussion pane.
# The discussion tree will display the number of unread replies for the discussion/reply to the right of the discussion/reply title if the user has read tracking enabled. See [[#ForumandDiscussionPane|Mockup: Forum and Discussion Pane]]
# Forums set to visible or separate groups will add the for and group name to the right of the discussion title when the post is set to a specific group in the discussion tree view. See [[#ForumandDiscussionPaneSeparateGroups|Mockup: Forum and Discussion Pane Separate Groups]] and [[#ForumandDiscussionPaneVisibleGroups|Mockup: Forum and Discussion Pane Visible Groups]]

===== Mockups =====

====== Forum and Discussion Pane ======

[[Image:afForumDiscussionPane.png|afForumDiscussionPane.png]]

====== Forum and Discussion Pane Expanded ======

[[Image:afForumDiscussionPaneExpanded.png|afForumDiscussionPaneExpanded.png]]

====== Forum and Discussion Pane Separate Groups ======

[[Image:afForumDiscussionPaneSeparateGroups.png|afForumDiscussionPaneSeparateGroups.png]]

====== Forum and Discussion Pane Visible Groups ======

[[Image:afForumDiscussionPaneVisibleGroups.png|afForumDiscussionPaneVisibleGroups.png]]

====== Discussion Accessible Display ======

[[Image:afAccessibleDiscussionDisplay.png|afAccessibleDiscussionDisplay.png]]

====== Selected Reply Accessible Display ======

[[Image:afAccessibleReplyDisplay.png|afAccessibleReplyDisplay.png]]

====== New Discussion Topic Modal ======

[[Image:afNewTopicModal.png|afNewTopicModal.png]]

===== Use Cases =====

====== Student Uses a Keyboard to Navigate Between Forum and Discussion Panel Areas ======

'''Description'''

A student navigates between the forum selector, add a new discussion topic and the discussion tree using a screen reader and their keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the F6 key to get to the filter pane
# The student uses the F6 key to get to the forum and discussion pane
# The student uses the tab key to navigate between the areas of the forum and discussion pane

'''Postconditions'''

# The student is able to navigate between the forum selector and discussion tree areas
# The student with the use of the screen reader understands the areas they are navigating between.

====== Student Selects a Different Forum Using a Keyboard ======

'''Description'''

A student navigates to a different forum without going back to the course page using a screen reader and their keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display
# The is more than one forum in the course

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the F6 key to get to the filter pane
# The student uses the F6 key to get to the forum and discussion pane
# The student tabs to the forum selector
# The student uses the spacebar to open the forum selector
# The student uses the down arrow to select the next forum in the course
# The student hits the enter key to select the forum

'''Postconditions'''

# The page is reloaded and the student is in the accessible view of the selected forum.

====== Teacher Adds a New Discussion Topic Using a Keyboard ======

'''Description'''

A teacher with a visual disability adds a new discussion topic to the forum using their screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a teacher
# An advanced forum has been created in the course
# The teacher has navigated to the course
# The teacher is using a screen reader
# The teacher has set the accessible forum display

'''Steps'''

# The teacher uses the screen reader to skip to the main content of the course
# The teacher tabs to the forum activity within the course
# The teacher hits the enter key
# The teacher uses the F6 key to get to the filter pane
# The teacher uses the F6 key to get to the forum and discussion pane
# The teacher uses the tab key to navigate to the ''Add a new discussion topic'' button
# The teacher hit the enter key
# The teacher uses tab to fill in all field in the ''Your new discussion topic modal''
# The teacher tabs to the ''Post to forum'' button
# The teacher hits the enter key

'''Postconditions'''

# The teacher’s post is saved
# The teacher’s browser focus is placed back on the forum and discussion pane.
# The discussion tree is updated with the new discussion.

====== Teacher Adds a New Discussion Topic For a Specific Group Using a Keyboard ======

'''Description'''

A teacher with a visual disability adds a new discussion topic to the forum using their screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a teacher
# An advanced forum has been created in the course
# The teacher has navigated to the course
# The teacher is using a screen reader
# The teacher has set the accessible forum display
# The advanced forum is set to separate groups

'''Steps'''

# The teacher uses the screen reader to skip to the main content of the course
# The teacher tabs to the forum activity within the course
# The teacher hits the enter key
# The teacher uses the F6 key to get to the filter pane
# The teacher uses the F6 key to get to the forum and discussion pane
# The teacher uses the tab key to navigate to the ''Add a new discussion topic'' button
# The teacher hit the enter key
# The teacher uses tab to fill in all field in the ''Your new discussion topic modal''
# The teacher selects a specific group from the group selector
# The teacher tabs to the ''Post to forum'' button
# The teacher hits the enter key

'''Postconditions'''

# The teacher’s post is saved
# The teacher’s browser focus is placed back on the forum and discussion pane.
# The discussion tree is updated with the new discussion.
# The discussion title has the words for <group name selected> to its right.

====== Teacher Keyboard is Locked in the Your New Discussion Topic Modal ======

'''Description'''

A teacher with a visual disability tabs through all live areas in the Your new discussion topic modal and can’t exist the modal until they hit enter for the close or cancel buttons.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a teacher
# An advanced forum has been created in the course
# The teacher has navigated to the course
# The teacher is using a screen reader
# The teacher has set the accessible forum display

'''Steps'''

# The teacher uses the screen reader to skip to the main content of the course
# The teacher tabs to the forum activity within the course
# The teacher hits the enter key
# The teacher uses the F6 key to get to the filter pane
# The teacher uses the F6 key to get to the forum and discussion pane
# The teacher uses the tab key to navigate to the ''Add a new discussion topic'' button
# The teacher hit the enter key
# The teacher hits the tab until they have listened to all fields in the modal
# The teacher hits tab until they find the close button

'''Postconditions'''

# The teacher’s keyboard focus is locked within the modal until they hit enter on the close or cancel buttons.

====== Student Expands a Discussion Using a Keyboard ======

'''Description'''

A student expands a discussion to listen to all of the replies to the discussion using a screen reader and their keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display
# More than one discussion has been created
# Replies have been posted to discussions

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the F6 key to get to the filter pane
# The student uses the F6 key to get to the forum and discussion pane
# The student uses the tab key to navigate to the discussion tree
# The student uses the left arrow key to expand the replies to the discussion

'''Postconditions'''

# All the titles for the replies of reply depth 1 for the discussion are showing and read to the user via the screen reader

====== Student Expands a Discussion Using a Mouse ======

'''Description'''

A student expands the replies to a discussion using their mouse.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student has set the accessible forum display
# More than one discussion has been created
# Replies have been posted to discussions

'''Steps'''

# The student clicks on the forum in the course
# The student clicks on the plus image to the left of the discussion title

'''Postconditions'''

# All the titles for the replies of reply depth 1 for the discussion are displayed

====== Student Navigated Down the Discussion Tree Using a Keyboard ======

'''Description'''

A student navigates to a reply to a discussion using a screen reader and their keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display
# More than one discussion has been created
# Replies have been posted to discussions

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the F6 key to get to the filter pane
# The student uses the F6 key to get to the forum and discussion pane
# The student uses the tab key to navigate to the discussion tree
# The student uses the down arrow to navigate to the next discussion in the tree

'''Postconditions'''

# The title of the discussion is read to the student via the screen reader

====== Student Selects a Discussion to Display Using a Keyboard ======

'''Description'''

A student selects a discussion using a screen reader and their keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display
# More than one discussion has been created
# Replies have been posted to discussions

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the F6 key to get to the filter pane
# The student uses the F6 key to get to the forum and discussion pane
# The student uses the tab key to navigate to the discussion tree
# The student uses the down arrow to navigate to the next discussion
# The student hits the enter key

'''Postconditions'''

# The student’s browser focus is set to the discussion pane
# The discussion pane is updated to display the full discussion plus all replies in the discussion.

====== Student Selects a Discussion Using a Mouse ======

'''Description'''

A student selects a discussion using their mouse.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student has set the accessible forum display
# More than one discussion has been created
# Replies have been posted to discussions

'''Steps'''

# The student clicks on the forum in the course
# The student clicks on the discussion title

'''Postconditions'''

# The student’s browser focus is set to the discussion pane
# The discussion pane is updated to display the full discussion plus all replies in the discussion.

====== Student Locates a Discussion With Unread Replies using a Keyboard ======

'''Description'''

A student navigates through the discussion tree until they hear a discussion that has new replies to it. The student is using the screen reader and their keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display
# More than one discussion has been created
# Replies have been posted to discussions

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the F6 key to get to the filter pane
# The student uses the F6 key to get to the forum and discussion pane
# The student uses the down arrow to located a discussion with unread replies

'''Postconditions'''

# Each discussion title is read as the user uses the down arrow to navigate down
# The discussion title is read then the number of unread replies.

====== Student Selects a Reply Using a Keyboard ======

'''Description'''

A student navigates to a reply and selects it to listen to in the discussion pane using a screen reader and their keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display
# More than one discussion has been created
# Replies have been posted to discussions

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the F6 key to get to the filter pane
# The student uses the F6 key to get to the forum and discussion pane
# The student uses the right arrow to expand a discussion
# The student hits the enter key

'''Postconditions'''

# The student’s browser focus is set to the discussion pane
# The discussion pane is updated to display the reply and all replies of a reply depth below the starting reply.

====== Student Selects a Reply Using a Mouse ======

'''Description'''

A student navigates to a reply and selects it to listen to in the discussion pane using their mouse.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student has set the accessible forum display
# More than one discussion has been created
# Replies have been posted to discussions

'''Steps'''

# The student clicks on the forum in the course
# The student clicks on the plus image to the left of the discussion title
# The student clicks on the reply title

'''Postconditions'''

# The student’s browser focus is set to the discussion pane
# The discussion pane is updated to display the reply and all replies of a reply depth below the starting reply.

==== Accessible Forum Discussion Display Pane ====

===== Description =====

The discussion display pane is the region of the forum that displays to the user the specific discussion or reply they have chosen with all sub replies. The pane is designed to present the selected discussion or reply in the most accessible manner focusing on simplified content and easy tabbing between actions. HTML headers are used to help inform the user where they are in the hierarchy of the discussion.

{note}It is understood that using HTML header’s to denote the hierarchy of the forum has the issue that HTML only has a header level up to H6. Furthermore H1 is only used once on a page and for the page heading. This is why the maximum reply depth setting has been added. It also should be noted that after a reply depth of 3 forum replies become less focused on the original discussion topic.{note}

===== Requirements =====

# The discussion pane will be separated into 2 areas: (See [[#DiscussionDisplayPaneStructure|Mockup: Discussion Display Pane Structure]])
## Message display area. This is a live area that is updated with message as information is added or removed via modals.
## Discussion/reply display area. This is dynamically updated based on modals and the forum and discussion pane.
# Messages in the message area will display for 30 seconds and then be removed from the page.
# The message output area will not be accessible if there are no messages.
# Each discussion or reply will be separated into 3 areas: (See [[#Discussion/ReplyStructure|Mockup: Discussion/Reply Structure]])
## Heading
## Post
### Post text
### File attachments
## Actions
# A discussion/reply heading will display the following information in this order: (See [[#TeacherViewsOwnDiscussion|Mockup: Teacher Views Own Discussion]])
## Post title using the correct HTML header based on reply depth (see below)
## Author with their image and name, the image will not be identified to a screen reader
## Post date, the date the post was created
## Rating type and value (this will only display if ratings are enabled)
# The accessible display mode will use HTML header tags for the title of the discussion post and replies. See [[#DiscussionAccessibleDisplay|Mockup: Discussion Accessible Display]]
# The discussion post will use a h2 HTML header tag for the title of the post. See [[#DiscussionAccessibleDisplay|Mockup: Discussion Accessible Display]]
# A replies reply depth will determine the HTML header tag to be used for the title: (See [[#DiscussionAccessibleDisplay|Mockup: Discussion Accessible Display]])
## Reply depth 1 will use the HTML header h3
## Reply depth 2 will use the HTML header h4
## Reply depth 3 will use the HTML header h5
## Reply depth 4 will use the HTML header h6
# Forums that allow a reply depth greater then 4 will use the HTML Header tag of H6 for all reply titles at a depth of 4 or greater.
# The post text area will display the post text and then any file attachments in an un ordered list below the. See [[#Discussion/ReplyStructure|Mockup: Discussion/Reply Structure]]
# If there are no actions available to the user then the action area will not display
# When the forum is set to separate groups and a discussion is set to all participants the action area will not display to students.
# Replies in the discussion pane will display based on the reply hierarchy and depth.
# If the teacher is the creator of the discussion or reply their name will be denoted in bold and the screen reader will read “Teacher” before reading the poster’s name.
# Anywhere in the below action menus if the action is subscribe it will be replaced with unsubscribe if the user is already subscribed to the discussion.
# Anywhere in the below action menus if the action bookmark is available the option remove bookmark will show if the discussion or reply is already bookmarked
# Anywhere in the below action menus if the action mark substantive is available the option Unmark substantive will show if the discussion or reply is already marked as substantive.
# Reply will display in the below action menus only if the user has permissions to create a reply
# Rating and view ratings will only display in the below action menus if the rating setting is enabled for the forum.
# A teacher will have the following actions available when viewing their own discussion: (See [[#TeacherViewsOwnDiscussion|Mockup: Teacher Views Own Discussion]])
## Edit
## Delete
## View ratings (only displays if ratings are enabled for the forum)
## Subscribe (will not display if subscribed to the forum or forum subscription is disabled)
## Mark substantive
## Bookmark
## Reply
# A teacher will have the following actions available when viewing their own reply: (See [[#TeacherViewsTeacherReply|Mockup: Teacher Views Teacher Reply]])
## Edit
## Split
## Delete
## View ratings (only displays if ratings are enabled for the forum)
## Mark substantive
## Bookmark
## Reply
# A teacher will have the following actions available when viewing a student’s reply: (See [[#TeacherViewsStudentReply|Mockup: Teacher Views Student Reply]])
## Reply
## Split
## Delete
## Rate (only displays if ratings are enabled for the forum)
## Mark substantive
## Bookmark
# A student will have the following actions available when viewing a discussion: (See [[#StudentViewsDiscussion|Mockup: Student Views Discussion]])
## Reply
## Rate
## Subscribe
# A student will have the following actions available when viewing their own reply: (See [[#StudentViewsOwnReply|Mockup: Student Views Own Reply]])
## Edit
## Delete
## Reply
# A private reply will display only to the student who created the original reply and the teachers.
# A teacher will have the following options available when viewing a private reply: (See [[#TeacherViewPrivateReply|Mockup: Teacher View Private Reply]])
## Edit
## Split
## Delete
# The action area will not display to a student for a private reply. See ([[#AnonymousReply|Mockup: Anonymous Reply]])
# The user’s picture will display as the default user picture for an anonymous forum. See ([[#AnonymousReply|Mockup: Anonymous Reply]])
# The user’s name will appear as a Anonymous user instead of the creators real name.
# A user will have all the same action menu options for an anonymous reply as they would for a reply of the same type in a regular forum.
# A user will be able to use the spacebar to open the action menu
# A user will be able to tab to an action menu
# A user will be able to use the enter key to select an action menu item.
# Selecting the reply action will bring up the reply modal.
# The student reply modal will have the fields in [[#StudentReplyModal|Mockup: Student Reply Modal]]
# The file upload area will not display if the forum is set to not allow attachments.
# The teacher reply modal will have additional form fields compared to a student’s reply modal based on the type of forum and the forum settings:See ([[#TeacherReplyModal|Mockup: Teacher Reply Modal]])
## Mail now
## Group (select box with available groups if the forum is set to visible or separate groups)
## Private reply
## Reveal yourself in this post (if the forum is set to anonymous)
# The reply modal will lock the user’s keyboard in the modal until the user clicks the ''Close'', ''Cancel'', or ''Post to forum'' button.
# Clicking the ''Post to forum'' button will cause the following things to happen:
## The reply is added as a reply to the discussion
## The modal closes
## The reply displays inline in the discussion/reply hierarchy
## Add a message to the message output area stating that the reply was successfully created and that the user has 30 minutes to edit the post.
## The message will be followed by a link to jump to the reply in the discussion display pane.
## The user’s browser focus is placed on the successful creation message.
# Selecting the split action will bring up the split post modal. See ([[#SplitPostModal|Mockup: Split Post Modal]])
# The split post modal will key the keyboard locked in the modal until the user clicks the ''Close'', ''Cancel'', or ''Split'' button.
# Clicking the ''Split'' button will cause the following things to happen:
## The Split post modal to close
## The Post and all of the replies to it or lower in the reply hierarchy to be converted to a discussion
## The post converted to the initial discussion post for the new discussion with the title in the new discussion title field of the modal
## A message to be added to the message display area stating that the post was successfully split and is displayed below.
## The discussion display pane will display the new discussion that the post was split into.
## The discussion tree in the forum and discussion pane is updated to reflect the changes to the forum.
# Selecting the delete action will bring up a conformation that the user wants to delete the reply or discussion. See ([[#DeleteReplyModal|Mockup: Delete Reply Modal]])
# Clicking the ''Delete post'' button will do the following things:
## Close the modal
## Remove the post and all of the replies lower in the hierarchy than the post.
## Add a successfully deleted message to the message output area.
## Place the user’s browser focus on the success message.
# The delete post modal will key the keyboard locked in the modal until the user clicks the ''Close'', ''Cancel'', or ''Delete post'' button.
# Selecting the edit action will bring up the reply modal pre-populated with the post that is being edited. See ([[#EditReplyModal|Mockup: Edit Reply Modal]])
# Selecting the rate action will bring up the rate modal pre-populated with the current rating the user has given the post. See [[#RatingModal|Mockup: Rating Modal]]
# The rate post modal will key the keyboard locked in the modal until the user clicks the ''Close'', ''Cancel'', or ''Rate post'' button.
# Clicking the rate button will cause the following things to happen:
## The rate post modal will close
## The rating the user had entered will be saved for the post
## The rating for the post will update based on the forum settings.
## A message will be printed in the message output area stating that the rating was successfully saved with a link to jump back to the post within the discussion display panel.
# Selecting the view ratings action will bring up the view ratings modal. See ([[#ViewRatingsModal|Mockup: View Ratings Modal]])
# The view ratings modal will keep the user’s keyboard focus until the user clicking on the ''Close'' or ''Close this window'' button.
# Closing a modal using the ''Close'', ''Close this window'' or ''Cancel'' buttons will place the user’s browser focus back on the action menu the user was on when they opened the modal.
# Any errors in the processing of a modal will display an error message in the message output area with a link back to the area the user was in when the error occurred.
# Selecting the subscribe action will do the following things:
## Subscribe the user to the discussion to receive emails when new replies are created in the discussion
## Display a message in the message output stating that the user has been subscribed to the discussion
## Place the user’s browser focus on the message output.
# Selecting the unsubscribe action will do the following things:
## Unsubscribe the user from the discussion and cause the user to stop receiving emails when new replies are created in the discussion
## Display a message in the message output stating that the user has been unsubscribed to the discussion
## Place the user’s browser focus on the message output.
# Selecting the bookmark action will do the following things:
## Add the bookmark flag to the post
## Display a message in the message output stating that the post was bookmarked
## The message will end with a link to jump to the post that was bookmarked.
## Place the user’s browser focus on the message output
# Selecting the Remove bookmark action will do the following things:
## Remove the bookmark flag from the post
## Display a message in the message output stating that the bookmark has been removed from the post
## The message will end with a link to jump to the post that the bookmark was removed from.
## Place the user’s browser focus on the message output
## The message will end with a link to jump to the post that the bookmark was removed from.
# Selecting the Mark substantive action will do the following things:
## Add the substantive flag to the post
## Display a message in the message output stating that the post was flagged as substantive
## The message will end with a link to jump to the post that was flagged as substantive
## Place the user’s browser focus on the message output
# Selecting the Remove substantive mark action will do the following things:
## Remove the substantive flag from the post
## Display a message in the message output stating that the substantive flag was removed from the post
## The message will end with a link to jump to the post the substantive flag was removed from.
## Place the user’s browser focus on the message output

===== Mockups =====

====== Discussion Display Pane Structure ======

[[Image:afDiscussionDisplayPaneStructure.png|afDiscussionDisplayPaneStructure.png]]

====== Discussion/Reply Structure ======

[[Image:afReplyStructure.png|afReplyStructure.png]]

====== Teacher Views Own Discussion ======

[[Image:afTeacherViewOwnDiscussion.png|afTeacherViewOwnDiscussion.png]]

====== Teacher Views Teacher Reply ======

[[Image:afTeacherViewTeacherReply.png|afTeacherViewTeacherReply.png]]

====== Teacher Views Student Reply ======

[[Image:afTeacherViewStudentReply.png|afTeacherViewStudentReply.png]]

====== Student Views Discussion ======

[[Image:afStudentViewDiscussion.png|afStudentViewDiscussion.png]]

====== Student Views Own Reply ======

[[Image:afStudentViewOwnReply.png|afStudentViewOwnReply.png]]

====== Teacher View Private Reply ======

[[Image:afPrivateReply.png|afPrivateReply.png]]

====== Anonymous Reply ======

[[Image:afAnonymousReply.png|afAnonymousReply.png]]

====== Student Reply Modal ======

[[Image:afStudentReplyModal.png|afStudentReplyModal.png]]

====== Teacher Reply Modal ======

[[Image:afTeacherReplyModal.png|afTeacherReplyModal.png]]

====== Rating Modal ======

[[Image:afRatingModal.png|afRatingModal.png]]

====== Split Post Modal ======

[[Image:afSplitModal.png|afSplitModal.png]]

====== Delete Post Modal ======

[[Image:afDeletePostModal.png|afDeletePostModal.png]]

====== Edit Reply Modal ======

[[Image:afEditModal.png|afEditModal.png]]

====== View Ratings Modal ======

[[Image:afViewRatingsModal.png|afViewRatingsModal.png]]

===== Use Cases =====

====== Student Listens to a Discussion Created by a Teacher ======

'''Description'''

A student selects a discussion using a screen reader and keyboard and listens to the screen reader read the discussion post.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the forum
# The student is using a screen reader
# The student has set the accessible forum display
# More than one discussion has been created by the teacher
# Replies have been posted to discussions

'''Steps'''

# The student uses the F6 key to get to the filter pane
# The student uses the F6 key to get to the forum and discussion pane
# The student uses the enter key to select the discussion

'''Postconditions'''

# The student is able to identify that the teacher created the discussion and not just another student.

====== Student Navigates Between Replies to a Discussion Using a Keyboard ======

'''Description'''

A student navigates between reply headings using the screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the forum
# The student is using a screen reader
# The student has set the accessible forum display
# More than one discussion has been created by the teacher
# The student has made a reply to a discussion

'''Steps'''

# The student uses the F6 key to get to the filter pane
# The student uses the F6 key to get to the forum and discussion pane
# The student uses the enter key to select the discussion
# The student uses the screen readers next header function to locate the next reply

'''Postconditions'''

# The student can identify by the header where they are within the forum hierarchy.
# The student is able to quickly navigate to each reply

====== Student Replies to a Discussion Using a Keyboard ======

'''Description'''

A student creates a reply to a discussion using a screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the forum
# The student is using a screen reader
# The student has set the accessible forum display
# More than one discussion has been created by the teacher
# Replies have been posted to discussions

'''Steps'''

# The student uses the F6 key to get to the filter pane
# The student uses the F6 key to get to the forum and discussion pane
# The student uses the enter key to select the discussion
# The student hits the tab key to tab to the action menu for the discussion
# The student hits the spacebar to open the action menu
# The student uses the down arrow to navigate to the reply action
# The student hits the enter key
# The student uses the tab key to tab through the forum fields and enter a reply
# The student tabs to the Post to forum button
# The student hits the enter key

'''Postconditions'''

# The reply is added to the discussion display pane in the proper place
# A message is displayed in the message output area
# The student hears the message

====== Student Edits a Reply Using a Keyboard ======

'''Description'''

A student edits a reply they have made using a screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the forum
# The student is using a screen reader
# The student has set the accessible forum display
# More than one discussion has been created by the teacher
# The student has made a reply to a discussion

'''Steps'''

# The student uses the F6 key to get to the filter pane
# The student uses the F6 key to get to the forum and discussion pane
# The student uses the enter key to select the discussion
# The student uses the screen readers next header keyboard commands to locate the reply they want to edit.
# The student hits the tab key to tab to the action menu for the discussion
# The student uses the spacebar to open the action menu
# The student uses the down arrow to select the edit menu item
# The student uses the enter key to select the edit menu item
# The student uses the tab key to navigate to the field they want to change
# The student uses the tab key to navigate to the ''Post to forum'' button
# The student hits the enter key to post the edits to the forum

'''Postconditions'''

# The reply is updated in the discussion display pane in the proper place
# A message is displayed in the message output area stating that the reply has been created and allowing the student to jump to the new reply.
# The student hears the message

====== Student’s Keyboard Stays Locked in the Reply Modal ======

'''Description'''

A student tabs through all of the options in the reply modal twice using a screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the forum
# The student is using a screen reader
# The student has set the accessible forum display
# More than one discussion has been created by the teacher
# The student has made a reply to a discussion

'''Steps'''

# The student uses the F6 key to get to the filter pane
# The student uses the F6 key to get to the forum and discussion pane
# The student uses the enter key to select the discussion
# The student uses the screen readers next header keyboard commands to locate the reply they want to reply to.
# The student hits the tab key to tab to the action menu for the discussion
# The student uses the spacebar to open the action menu
# The student uses the down arrow to select the edit menu item
# The student uses the enter key to select the edit menu item
# The student uses the tab key to navigate through all the modal fields twice

'''Postconditions'''

# The user always tabs within the modal and the keyboard focus never leaves the modal.

====== Student Jumps to a Newly Created Reply ======

'''Description'''

A student jumps to the reply they have made using a screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the forum
# The student is using a screen reader
# The student has set the accessible forum display
# More than one discussion has been created by the teacher
# The student has made a reply to a discussion

'''Steps'''

# The student uses the F6 key to get to the filter pane
# The student uses the F6 key to get to the forum and discussion pane
# The student uses the enter key to select the discussion
# The student uses the screen readers next header keyboard commands to locate the reply they want to reply to.
# The student hits the tab key to tab to the action menu for the discussion
# The student uses the spacebar to open the action menu
# The student uses the down arrow to select the edit menu item
# The student uses the enter key to select the edit menu item
# The student uses the tab key to fill out all the fields in the forum
# The student uses the tab key to navigate to the ''Post to forum'' button
# The student hits the enter key to post the reply to the forum
# The student hits the enter key when the screen reader reads the link to jump to the newly created reply

'''Postconditions'''

# The user’s browser focus is placed on the header for the reply they just created.

====== Student Subscribes to a Discussion Using a Keyboard ======

'''Description'''

A student subscribes to a discussion using a screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the forum
# The student is using a screen reader
# The student has set the accessible forum display
# More than one discussion has been created by the teacher
# The forum is set to optional forum subscriptions.
# The student is not subscribed to the forum
# The student has not subscribed to the discussion

'''Steps'''

# The student uses the F6 key to get to the filter pane
# The student uses the F6 key to get to the forum and discussion pane
# The student uses the enter key to select the discussion
# The student uses the screen readers next header keyboard commands to locate the reply they want to subscribe to.
# The student hits the tab key to tab to the action menu for the discussion
# The student uses the spacebar to open the action menu
# The student uses the down arrow to select the subscribe menu item
# The student uses the enter key to select the subscribe menu item

'''Postconditions'''

# The student is subscribed to the discussion
# A message is displayed in the message output area stating that the student has been subscribed to the discussion.
# The student hears the message

====== Student Accesses a Discussion’s Action Menu Using a Mouse ======

'''Description'''

A student displays a discussion’s action menu using a mouse.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the forum
# The student is using a screen reader
# The student has set the accessible forum display
# More than one discussion has been created by the teacher

'''Steps'''

# The student clicks on the discussion
# The student clicks on the action menu for the discussion

'''Postconditions'''

# The action menu expands

====== Teacher Rates a Post Using a Keyboard ======

'''Description'''

A teacher rates a student’s post using a screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a teacher
# An advanced forum has been created in the course
# The teacher has navigated to the course
# The teacher is using a screen reader
# The teacher has set the accessible forum display
# The teacher has created a discussion
# A student has made a reply to a discussion
# The forum is set to allow rating
# The student reply has not been rated

'''Steps'''

# The teacher uses the F6 key to get to the filter pane
# The teacher uses the F6 key to get to the forum and discussion pane
# The teacher uses the enter key to select the discussion
# The teacher uses the screen readers next header keyboard commands to locate the reply they want to rate.
# The teacher hits the tab key to tab to the action menu for the discussion
# The teacher uses the spacebar to open the action menu
# The teacher uses the down arrow to select the rate menu item
# The teacher uses the enter key to select the rate menu item
# The teacher uses the spacebar to open the rating select box
# The teacher uses the down arrow to select the rating they want.
# The teacher hits the enter key to select the rating for the post
# The teacher uses the tab key to navigate to the rate button.
# The teacher uses the enter key to rate the post.

'''Postconditions'''

# The post is rated
# The post’s rating is recalculated
# A message is displayed in the message output area stating that the post has been rated and allowing the teacher to jump to the post they rated.
# The student hears the message

====== Teacher Deletes a Discussion Using a Keyboard ======

'''Description'''

A teacher deletes a discussion using a screen reader and keyboard

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a teacher
# An advanced forum has been created in the course
# The teacher has navigated to the course
# The teacher is using a screen reader
# The teacher has set the accessible forum display
# A discussion has been created in the forum
# A reply has been made to the discussion

'''Steps'''

# The teacher uses the F6 key to get to the filter pane
# The teacher uses the F6 key to get to the forum and discussion pane
# The teacher uses the enter key to select the discussion
# The teacher hits the tab key to tab to the action menu for the discussion
# The teacher uses the spacebar to open the action menu
# The teacher uses the down arrow to select the delete menu item
# The teacher uses the enter key to select the delete menu item
# The teacher uses the spacebar to open the delete select box
# The teacher listens to the modal window text
# The teacher uses the tab key to navigate to the delete post button.
# The teacher uses the enter key to delete post button to delete the post.

'''Postconditions'''

# The post is deleted
# A message is displayed in the message output area stating that the post has been deleted and allowing the teacher to jump back to the forum and discussion pane
# The student hears the message

====== Teacher the Views Ratings for a Post Using a Keyboard ======

'''Description'''

A teacher views the ratings that have been given for a student’s post using a screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a teacher
# An advanced forum has been created in the course
# The teacher has navigated to the course
# The teacher is using a screen reader
# The teacher has set the accessible forum display
# The teacher has created a discussion
# A student has made a reply to a discussion
# The teacher and others have rated a student’s reply

'''Steps'''

# The teacher uses the F6 key to get to the filter pane
# The teacher uses the F6 key to get to the forum and discussion pane
# The teacher uses the enter key to select the discussion
# The teacher uses the screen readers next header keyboard commands to locate the reply they want to view the ratings for.
# The teacher hits the tab key to tab to the action menu for the discussion
# The teacher uses the spacebar to open the action menu
# The teacher uses the down arrow to select the view ratings menu item
# The teacher uses the enter key to select the view ratings menu item

'''Postconditions'''

# The view ratings modal appears with all the ratings that have been submitted for the post.

====== Teacher Splits a Reply Using a Keyboard ======

'''Description'''

A teacher splits a reply into a new discussion using a screen reader and keyboard

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a teacher
# An advanced forum has been created in the course
# The teacher has navigated to the course
# The teacher is using a screen reader
# The teacher has set the accessible forum display
# The teacher has created a discussion
# The reply has multiple replies to it.

'''Steps'''

# The teacher uses the F6 key to get to the filter pane
# The teacher uses the F6 key to get to the forum and discussion pane
# The teacher uses the enter key to select the discussion
# The teacher uses the screen readers next header keyboard commands to locate the reply they want to split.
# The teacher hits the tab key to tab to the action menu for the discussion
# The teacher uses the spacebar to open the action menu
# The teacher uses the down arrow to select the split menu item
# The teacher uses the enter key to select the split menu item
# The teacher uses the tab key to tab to the new discussion title field and enters a discussion title
# The teacher tabs to the split button
# The teacher hits the enter key to split the reply

'''Postconditions'''

# A new discussion is created from the reply with the title provided in the new discussion title field
# A message appears in the message output area that states the reply was split.
# The teacher’s browser focus is set to the message output
# The discussion display pane shows the newly created discussion
# The discussion tree in the forum and discussion pane is updated with the new discussion.

====== Teacher Marks a Post as Substantive Using a Keyboard ======

'''Description'''

A teacher marks a post as substantive using a screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a teacher
# An advanced forum has been created in the course
# The teacher has navigated to the course
# The teacher is using a screen reader
# The teacher has set the accessible forum display
# The teacher has created a discussion
# A student has made a reply to a discussion

'''Steps'''

# The teacher uses the F6 key to get to the filter pane
# The teacher uses the F6 key to get to the forum and discussion pane
# The teacher uses the enter key to select the discussion
# The teacher uses the screen readers next header keyboard commands to locate the reply they want mark as substantive.
# The teacher hits the tab key to tab to the action menu for the discussion
# The teacher uses the spacebar to open the action menu
# The teacher uses the down arrow to select the mark substantive menu item
# The teacher uses the enter key to select the mark substantive menu item

'''Postconditions'''

# The post is marked as substantive
# A message is added to the message output area stating that the post has been marked substantive and a link is included to allow the teacher to jump to the post.
# The teacher’s browser focus is placed on the message output.
# The teacher hears the message read to them.

====== Teacher Bookmarks a Post Using a Keyboard ======

'''Description'''

A teacher bookmarks a post using a screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a teacher
# An advanced forum has been created in the course
# The teacher has navigated to the course
# The teacher is using a screen reader
# The teacher has set the accessible forum display
# The teacher has created a discussion
# A student has made a reply to a discussion

'''Steps'''

# The teacher uses the F6 key to get to the filter pane
# The teacher uses the F6 key to get to the forum and discussion pane
# The teacher uses the enter key to select the discussion
# The teacher uses the screen readers next header keyboard commands to locate the reply they want to view the ratings for.
# The teacher hits the tab key to tab to the action menu for the discussion
# The teacher uses the spacebar to open the action menu
# The teacher uses the down arrow to select the bookmark menu item
# The teacher uses the enter key to select the bookmark menu item

'''Postconditions'''

# The post is flagged as bookmarked
# A message is added to the message output area stating that the post has been bookmarked and a link is included to allow the teacher to jump to the post.
# The teacher’s browser focus is placed on the message output.
# The teacher hears the message read to them.

=== Glossary ===

* '''Reply depth:''' The hierarchical level that a reply is on. A reply to a discussion is reply depth 1. A reply to a reply is depth 2. A reply to a reply to a reply is depth 3. Example: Discussion (depth 0) Reply (depth 1) Reply 2 (depth 2) Replay 3 (depth 3) Reply 4 (depth 2) Replay 5 (depth 1)

=== Document Change Management ===

==== Revision Summary ====

==== Revision History ====

=== Open Questions ===

==See also==

[https://tracker.moodle.org/browse/MDL-39707]

[[Category: Project]]

Advanced Forums Accessible Display Specification

2013-07-25T00:31:03Z

Psychoph:

=== Visioning ===

==== Overview ====

The Moodle forums is not as accessible as it could be. In order to improve usability of forums for those with disabilities Moodlerooms is will enhance advanced forums to display discussions based on EASI: Equal Access to Software & Information’s accessible forum design.

==== Business Goals ====

# Progress towards NFB Certification
# Keep strategic clients
# Improve sales for prospects with high accessibility requirements.

==== Product Goals ====

# Increase the accessibility of forum discussion display
# Increase usability of forums

==== Business References ====

* University of Montana (UofM)
* National Federation of the Blind (NFB)
* Department of Education

=== Scenarios ===

==== Administrator Sets Advanced Forums as the Forums for All Forums on a Site ====

The administrator needs to force all forums to be created as advanced forums to meet the institutions accessibility policy. To do this the administrator sets all news forums to be created as advanced forums and disabled each roles capabilities to create forums.

==== Teacher Restricts Number of Replies ====

In order to keep forum conversations on topic the student wants to keep the depth of replies to a minimal. After a number of replies to replies a user will not be able to create a reply to a reply.

==== A Visually Impaired Student Listens to Posts in a Course Forum ====

A student needs to review the new posts that students and students have posted to their course forums. Using a screen reader the student accesses the forum and listens to the replies that have been made in the forum.

==== A Visually Impaired Student Replies to a Post in a Course Forum ====

A student wants to reply to a discussion made by the student. Using a screen reader the student navigates to the discussion and hits return when they find the reply link. The student is then placed in a text editor to create their reply. The student then saves the reply by navigating to the post button.

==== A Visually Impaired Student Sorts Forum Discussions ====

A student wants to sort the discussions by which have the newest posts in order to understand what the latest changes are to the forum. The student navigates to the sort using a screen reader and hits enter when they have found the sort by newest post.

=== References ===

==== Jira ====

==== Technical ====

* [http://easi.cc/archive/bb2013/recording/index.htm Recording of a discussion on the accessible prototype (EASI)]
* [https://dl.dropboxusercontent.com/u/137779786/discussion_module_mockup/discussion_board-listview.html Prototype of an accessible forum (ESAI) ]
* [http://www.oaa-accessibility.org/examples/ OpenAjax Accessibility examples]
* [http://webaim.org/techniques/keyboard/accesskey WebAIM on keyboard shortcuts]

=== Feature Information ===

==== Advanced Forums Site Settings ====

===== Description =====

Advanced forums will allow administrators to set the default forum display (renamed from discussion display) for all users. Advanced forums will also allow a site administrator to set the default maximum reply depth.

===== Requirements =====

# Rename Discussion display to Forum display in advanced forums display types.
# A new checkbox administrative settings called Create news forums as advanced forums will be added to the activity’s administrative settings page. See [[#AdvancedForumAdministrativeSettings|Mockup: Advanced Forum Administrative Settings]]
# The default value for the Create news forums as advanced forums is unchecked aka no.
# A new select box administrative settings called Default forum display will be added to the activity’s administrative settings page. See [[#AdvancedForumAdministrativeSettings|Mockup: Advanced Forum Administrative Settings]]
# The default value for the Default forum display is default
# The possible values for the Default forum display will be:
## Accessible
## Default
## Nested
## Tree
# A new administrative settings called Maximum reply depth will be added to the activity’s administrative settings page. See [[#AdvancedForumAdministrativeSettings|Mockup: Advanced Forum Administrative Settings]]
# The default value for the Maximum reply depth will be 3. See [[#AdvancedForumAdministrativeSettings|Mockup: Advanced Forum Administrative Settings]]

===== Mockups =====

====== Advanced Forum Administrative Settings ======

[[Image:afAdminSettings.png|afAdminSettings.png]]

===== Use Cases =====

====== Administrator Sets Default Forum Display ======

'''Description'''

The administrator sets the default forum display to accessible.

'''Preconditions'''

# The user is logged in
# The user is assigned as a site administrator
# The user is at the site level

'''Steps'''

# The administrator clicks on the ''Plugins'' link group under the Settings block
# The administrator clicks on the ''Activity modules'' link group
# The administrator clicks on the ''Advanced forums'' link
# The administrator selects ''Accessible'' from the ''Default forum display'' select box
# The administrator clicks the ''Save changes'' button

'''Postconditions'''

# the settings are saved

====== Administrator Sets the Site to Create all News Forums as Advanced Forums ======

'''Description'''

The administrator sets the site to use advanced forums for all newly created news forums.

'''Preconditions'''

# The user is logged in
# The user is assigned as a site administrator
# The user is at the site level

'''Steps'''

# The administrator clicks on the ''Plugins'' link group under the Settings block
# The administrator clicks on the ''Activity modules'' link group
# The administrator clicks on the ''Advanced forums'' link
# The administrator clicks the checkbox to the left of Create all new forums as advanced forums
# The administrator clicks the ''Save changes'' button

'''Postconditions'''

# The settings are saved

====== Administrator Sets the Default Maximum Reply Depth ======

'''Description'''

The administrator sets the default maximum reply depth for all newly created forums to be 1.

'''Preconditions'''

# The user is logged in
# The user is assigned as a site administrator
# The user is at the site level

'''Steps'''

# The administrator clicks on the ''Plugins'' link group under the Settings block
# The administrator clicks on the ''Activity modules'' link group
# The administrator clicks on the ''Advanced forums'' link
# The administrator enters 1 in the text box to the right of the Maximum reply depth setting.
# The administrator clicks the ''Save changes'' button

'''Postconditions'''

# The settings are saved.

====== Administrator Creates a Course With an Advanced Forums News Forum ======

'''Description'''

The administrator creates a course with a news forum. The news forum is created as an advanced forum.

'''Preconditions'''

# The user is logged in
# The user is assigned as a site administrator
# The advanced forum setting create news forums as advanced forums is checked.
# The user is at the site level

'''Steps'''

# The administrator clicks the ''Courses'' link group
# The administrator clicks the ''Add/edit courses'' link
# The administrator clicks the ''Add a new course'' button
# The administrator fills out the course information
# The administrator clicks the ''Save changes'' button

'''Postconditions'''

# The news forum created for the course is an advanced forum.

==== Advanced Forum Accessible Settings ====

===== Description =====

A new setting will be added to the create a forum screen that will allow the student to restrict the maximum depth of replies for a discussion.

===== Requirements =====

# A new setting will be added to the create a forum screen under the general group called maximum [[#replydepth|reply depth]]. See [[#AdvancedForumDepthSetting|Mockup: Advanced Forum Depth Setting]]
# The default value for the maximum [[#replydepth|reply depth]] will be 3
# The maximum [[#replydepth|reply depth]] will be 7
# Once the [[#replydepth|reply depth]] in a discussion reaches maximum reply depth the a student will not be able to reply to the reply. See [[#MaximumReplyDepthDisplay|Mockup: Maximum Reply Depth Display]]
# When a teacher creates a reply to the maximum depth reply the reply will be marked automatically as a private reply.
# A teacher will be unable to uncheck the private reply checkbox for a reply to a reply at the maximum reply depth. See [[#TeacherReplytoaMaximumDepthReply|Mockup: Teacher Reply to a Maximum Depth Reply]]

===== Mockups =====

====== Advanced Forum Depth Setting ======

[[Image:afMaxDepthSetting.png|afMaxDepthSetting.png]]

====== Maximum Reply Depth Display ======

[[Image:afMaxReplyDepthDisplay.png|afMaxReplyDepthDisplay.png]]

====== Teacher Reply to a Maximum Depth Reply ======

[[Image:afMaxReplyPrivateReply.png|afMaxReplyPrivateReply.png]]

===== Use Cases =====

====== Teacher Creates a Forum with a Maximum Reply Depth of 2 ======

'''Description'''

The student wants to limit the reply depth to 2 to keep the students on track with the forum discussion.

'''Preconditions'''

# The user is logged in
# The users is assigned the student role in the course
# The user has navigated to the course
# The course is set to weeks or topics format

'''Steps'''

# The student clicks on the add activity link
# The student selects Advanced forum
# The student fills out the forum information
# The student selects one from the select box for maximum reply depth

'''Postconditions'''

# Users cannot reply to a reply or a reply
# The student can still create a private reply to a reply of a reply

====== A Student Views a Reply at the Maximum Reply Depth ======

'''Description'''

A student views a reply that is at the maximum reply depth.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course with a maximum reply depth
# The forum has multiple replies with one at the maximum reply depth
# The student has navigated to the course

'''Steps'''

# The student clicks on the forum
# The student scrolls to the reply at the maximum reply depth

'''Postconditions'''

# The student doesn’t see the reply link.

====== A Teacher Replies to a Maximum Reply Depth Reply ======

'''Description'''

The student wants to create a private reply to the student’s reply even though it is at the maximum reply depth.

'''Preconditions'''

# The user is logged in
# The user is assigned to the student role in a course
# An advanced forum has been created in the course with a maximum reply depth
# The forum has multiple replies with one at the maximum reply depth
# The student has navigated to the course

'''Steps'''

# The student clicks on the forum
# The student scrolls to the reply at the maximum reply depth
# The student clicks on the reply link
# The student fills out the reply form
# The student clicks the ''Post to forum'' button

'''Postconditions'''

# The Private reply checkbox is checked and disabled
# The student can’t change the reply to a non private reply.

==== Private Reply Display ====

===== Description =====

To improve the accessibility of private replies Moodlerooms will add a string to the front of private replies to identify them to the user.

===== Requirements =====

# Private replies will have the string Private reply: added to the front of the title for the reply. See [[#PrivateReplyDisplay|Mockup: Private Reply Display]]
# The string Private reply will be translatable.

===== Mockups =====

====== Private Reply Display ======

[[Image:afPrivateReply.png|afPrivateReply.png]]

===== Use Cases =====

====== Student Views a Private Reply ======

'''Description'''

A student views a private reply from a student in a forum.

'''Preconditions'''

# The user is logged in
# The user is assigned to the student role in a course
# The student has created a reply in a forum
# A student has created a private reply to the student’s reply
# The user has navigated to a course with a private reply in it

'''Steps'''

# The student clicks on the forum
# The student scrolls to view the private reply

'''Postconditions'''

# The string Private reply shows in front of the title for the reply.

==== Accessible Discussion Display ====

===== Description =====

The current display options in advanced forums do not maximize the view for those with disabilities. The accessible discussion display will work to implement the prototype of an accessible forum by ESAI. Users will be able to switch between this discussion display and any other discussion display types.

===== Requirements =====

# A new discussion display mode will be added to the forum display drop down called accessible.
# The accessible forum display will be separated into 5 areas (See [[#AccessibleDisplayStructure|Mockup: Accessible Display Structure]])
## Moodle breadcrumb at the top
## Filter pane at the top
## Forum description (Only shown if set)
## Forum and Discussion selection pane on the left
## Discussion display pane on the right
# Forum management will still be maintained within Moodle’s navigation and settings blocks and accessed via the themes block display.
# The breadcrumb will initially display the full moodle path to the forum the user selected within the course. See [[#NoDiscussionSelected|Mockup: No Discussion Selected]]
# The user will be able to use skip navigation to jump to the forum/discussion pane. See [[#AccessibleDisplayStructure|Mockup: Accessible Display Structure]]
# Navigation from the Discussion display pane to the Forum and Discussion selection pane
# The access key 1 will be used to move to the focus to the Forum select box
# The access key 2 will be used to move the focus to the discussion selection tree view
# The F6 key will be used to to switch focus to the next pane of the filter, forum and discussion and the discussion display panes. See [[#AccessibleDisplayStructure|Mockup: Accessible Display Structure]]
# The Shift+F6 keys will be used to switch focus to the previous pane of the filter, forum and discussion and the discussion display panes. See [[#AccessibleDisplayStructure|Mockup: Accessible Display Structure]]
# When navigating between panes a screen reader will be informed of the region the user has navigated to.

====== Accessible Display Structure ======

[[Image:afAccessibleDisplayStructure.png|afAccessibleDisplayStructure.png]]

====== No Discussion Selected ======

[[Image:afNoDiscussionSelected.png|afNoDiscussionSelected.png]]

===== Use Cases =====

====== Student Selects Accessible Forum Display ======

'''Description'''

A student will a visual disability wants to maximize their usability of advanced forums and selects the accessible forum display type.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course with a maximum reply depth
# The student has navigated to the course
# The student is using a screen reader

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the screen reader to skip to the main content of the page
# The student tabs to the forum display select drop down
# The student uses the space button to open the the select drop down
# The student uses the arrow keys to highlight the accessible select option
# The student hits the enter key

'''Postconditions'''

# The page reloads
# The accessible forum display appears

====== Student Uses F6 to Navigate Between Panes ======

'''Description'''

A visually impaired user wants to quickly change between the panes in the accessible forum view using the F6 key.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student hits the F6 key

'''Postconditions'''

# The student is taken to the filter pane
# The student is informed they are in the filter region

====== Student Uses Shift+F6 to Navigate Between Panes ======

'''Description'''

A student wants to navigate back through the panes of the accessible forum display using the shift+F6 key combination.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student hits the Shift+F6 key combination

'''Postconditions'''

# The student is taken to the discussion display pane
# The student is informed they are in the discussion display region

====== Student Uses Access key 1 to Navigate to the Forum Selection box ======

'''Description'''

A student wants to jump directory to the forum selector to change the forum they are viewing.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student clicks the screen reader’s key combination for the access 1 key

'''Postconditions'''

# The keyboard focus is set of the forum selector box box

====== Student Uses Access key 2 to Navigate to the Discussion Selection Tree view ======

'''Description'''

A student wants to jump to the discussion tree selector to quickly select a new reply to listen to.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student clicks the screen reader’s key combination for the access 2 key

'''Postconditions'''

# The keyboard focus is set of the discussion selector tree view box

==== Accessible Forum Display Filter Pane ====

===== Description =====

In order to quickly access the information users need from the forums they will need to be able to sort and filter the discussions in the forum. Users will also need to be able to change the forum display to their preferred display from the default or current display.

===== Requirements =====

{note}See original [Specs 2.4 Advanced Forums] for how discussions are sorted using each sort by type{note}

# The filter pane will display the following menus based on the forum configuration for the teacher: (See [[#FilterPaneExpandedTeacher|Mockup: Filter Pane Expanded Teacher]])
## Group menu (only displayed if visible or separate groups is set for the forum)
### All participants
### List of all groups in the grouping assigned to the forum.
## Sort by (each menu item will have a sub menu for changing the sort to ascending or descending)
### Last post date
### Creation date
### Last name
### First name
### Number of replies
## Forum display
### Accessible
### Default
### Nested
### Tree
# The filter pane will display the following menus based on the forum configuration for the student: (See [[#FilterPaneExpandedStudent|Mockup: Filter Pane Expanded Student]])
## Sort by (each menu item will have a sub menu for changing the sort to ascending or descending)
### Last post date
### Creation date
### Last name
### First name
### Number of replies
## Forum display
### Accessible
### Default
### Nested
### Tree
# The filter pane will display the simple forum search form for all users. See [[#FilterPane|Mockup: Filter Pane]]
# The user will be able to tab to the first menu and the search field
# The user will use the left and right arrows to switch between menus and to open sub menus
# The user will use the up and down arrows to navigate between menu items
# The user will use the spacebar to open the menu
# Selecting a sort by option will open up the ascending or descending sub menu. See [[#FilterPaneExpandedStudent|Mockup: Filter Pane Expanded Student]]
# Selecting ascending or descending in a sort by submenu will rest the discussion display pane to its default state. See [[#NoDiscussionSelected|Mockup: No Discussion Selected]]
# Selecting ascending or descending in a sort by submenu will rest the page’s Moodle breadcrumb to the path to the current forum. See [[#NoDiscussionSelected|Mockup: No Discussion Selected]]
# Selecting ascending or descending will sort the discussion list based on the sort by and ascending or descending selection.
# Selecting ascending or descending will set the student’s focus to the Discussion tree view.
# If the forum is not set to use groups in the forum settings then the view group menu in the top navigation will not display. See [[#FilterPaneExpandedStudent|Mockup: Filter Pane Expanded Student]]
# Selecting a group in the view group selector will change the discussion pane to display only discussions for that group and all participants.
# Selecting a group in the view group selector will focus the user on the Discussion tree view
# Selecting a group will reset the discussion view pane to its default state of no discussion or reply being displayed. See [[#NoDiscussionSelected|Mockup: No Discussion Selected]]
# Selecting a group will reset the Moodle breadcrumb to the path to the current forum. See [[#NoDiscussionSelected|Mockup: No Discussion Selected]]
# Selecting a display type in the forum display menu will cause the page to reload and the new forum display to display the forum. See [[#NoDiscussionSelected|Mockup: No Discussion Selected]]
# Clicking the ''Search'' button will bring up the search results in the discussion display pane. See [[#SearchResults|Mockup: Search Results]]
# The search one the filter pane will search only the current forum.
# Clicking the ''Advanced search'' button will display the Advanced search modal. See [[#AdvancedSearchModal|Mockup: Advanced Search Modal]]
# The advanced search modal will lock the user’s keyboard in the modal until the user click the ''Close'', ''Cancel'', or ''Search forums'' button.
# Clicking the ''Search'' button on the filter pane or the ''Search forums'' button in the advanced search modal will display the search results in the discussion display pane. See [[#SearchResults|Mockup: Search Results]]
# The user’s browser focus will be placed on the discussion display pane after a search has finished.
# The search results will display the same as described in the [[#AccessibleForumDiscussionDisplayPane|Section: Accessible Forum Discussion Display Pane]] with a header titled Search results with a count of the number of posts found.
# The action menu for each post in the search results will consist of the following links: (See [[#SearchResults|Mockup: Search Results]])
## Show post in full discussion
## Show post and its replies
# Selecting Show post in full discussion in the action menu will cause the following to happen:
## The discussion display pane will display all posts in the discussion the post is in.
## The user’s browser focus will be placed on the post in the discussion display pane
# Selecting Show post and its replies in the action menu will cause the following to happen:
## The discussion display pane display the post and all replies to the post in the discussion hierarchy.
## The user’s browser focus will be placed on the post in the discussion display pane

===== Mockups =====

====== Filter Pane ======

[[Image:afFilterPane.png|afFilterPane.png]]

====== Filter Pane Expanded Teacher ======

[[Image:afFilterPaneExpandedTeacher.png|afFilterPaneExpandedTeacher.png]]

====== Filter Pane Expanded Student ======

[[Image:afFilterPaneExpandedStudent.png|afFilterPaneExpandedStudent.png]]

====== Search Results ======

[[Image:afSearchResults.png|afSearchResults.png]]

====== Advanced Search Modal ======

[[Image:afAdvancedSearchModal.png|afAdvancedSearchModal.png]]

===== Use Cases =====

====== Student Accesses the Sort by Menu Using a Keyboard ======

'''Description'''

A student accesses the sort by menu drop down using a screen reader and their keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the screen reader to jump to the main content
# The student uses the tab key to tab to the sort by menu

'''Postconditions'''

# Using the tab key the student is able to find the sort by menu
# The student is able to identify using the screen reader which menu they are on.

====== Student Accesses the Search Field Using a Keyboard ======

'''Description'''

A student accesses the search input field using a screen reader and their keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the screen reader to jump to the main content
# The student uses the tab key to tab to the search input field

'''Postconditions'''

# The student is able to identify that entering text in the field will search to forum for posts with that information in it.
# The student is able to identify they are in a form and need to tab to the ''Search forum'' button

====== Student Opens Sort By Menu Using a Keyboard ======

'''Description'''

A student opens the sort by menu using a screen reader and their keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the screen reader to jump to the main content
# The student uses the tab key to tab to the sort by menu
# The student uses the spacebar to open the sort by menu

'''Postconditions'''

# The sort by menu opens for the student
# The screen reader reads all of the sort by menu items.

====== Student Selects Sort By Number of Replies Descending Using a Keyboard ======

'''Description'''

A student selects sort by number or replies in a descending order using a screen reader and their keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display
# The advanced forum has more than 1 discussion and reply

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the screen reader to jump to the main content
# The student uses the tab key to tab to the sort by menu
# The student uses the spacebar to open the sort by menu
# The student uses the down arrow key to locate the ''Number of replies'' menu item
# The student uses the right arrow key to open the ''Number of replies'' sub menu
# The student uses the down arrow key to select the ''Descending'' menu item

'''Postconditions'''

# The discussion list is resorted by number of replies in a descending order
# The student’s browser focus is set to the discussion tree view
# The student is able to understand via the screen reader that they are not accessing the discussion tree view.

====== Student Navigates Between Menus Using a Keyboard ======

'''Description'''

A student accesses each menu using a keyboard and screen reader.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the screen reader to jump to the main content
# The student uses the tab key to tab to the sort by menu
# The student uses the left arrow key to navigate to the forum display menu

'''Postconditions'''

# The student is able to navigate to the forum display using the keyboard

====== Student Selects a Display Type Using a Keyboard ======

'''Description'''

A student changes the display type from accessible to default using a screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the screen reader to jump to the main content
# The student uses the tab key to tab to the sort by menu
# The student uses the left arrow key to navigate to the forum display menu
# The student uses the spacebar to open the forum display menu
# The student uses the down arrow key to select a new forum display type

'''Postconditions'''

# The student is able to navigate to the forum display using the keyboard
# The page is reloaded and the forum is displayed using the new forum display type

====== Teacher Selects a Group Using a Keyboard ======

'''Description'''

A student filters the lists of discussions by group using a screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display
# The advanced forum is setup to have separate groups
# Students are assigned to groups
# The forum has posts to each group as well as all participants.

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the screen reader to jump to the main content
# The student uses the tab key to tab to the sort by menu
# The student uses the left arrow key to navigate to the view group menu
# The student uses the spacebar to open the view group menu
# The student uses the down arrow key to select a group to view

'''Postconditions'''

# The discussion tree view is updated with the discussions available to the selected group and all participants
# The student’s browser focus is set to the discussion tree view.

====== Student Searches the Forum Using a Keyboard ======

'''Description'''

A student uses a screen reader and keyboard to access the search input field in the filter pane and search the forum.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display
# There are discussion in the forum
# There are replies in the forum
# There are replies or discussions that match the search criteria in the forum.

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the F6 key to navigate to the filter pane
# The student tabs to the search input field
# The student enters their search text in the search input field
# The student tabs to the search button
# The student hits the enter key to search the forums

'''Postconditions'''

# The posts that are found matching the search criteria display in the discussion display pane
# The user’s browser focus is set to the discussion display pane.

====== Student Uses the Advanced Search to Search the Forum Using a Keyboard ======

'''Description'''

A student search the forum using the advanced search modal, a screen reader and a keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display
# There are discussion in the forum
# There are replies in the forum
# There are replies or discussions that match the search criteria in the forum.

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the F6 key to navigate to the filter pane
# The student tabs to the advanced search button
# The student hits the enter key
# The student uses the tab key to fill out the search criteria
# The student tabs to the search forum button
# The student hits enter to search the forum

'''Postconditions'''

# The posts that are found matching the search criteria display in the discussion display pane
# The user’s browser focus is set to the discussion display pane.

====== Student Displays the Discussion the Search Result is a Part of Using a Keyboard ======

'''Description'''

A student selects the to view the discussion that a search result post is a part of using a screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display
# There are discussion in the forum
# There are replies in the forum
# There are replies or discussions that match the search criteria in the forum.
# The user has finished searching via advanced search or simple search.

'''Steps'''

# The student uses the screen readers next header keyboard commands to locate the reply they want to edit.
# The student hits the tab key to tab to the action menu for the discussion
# The student uses the spacebar to open the action menu
# The student uses the down arrow to select the Show post in full discussion menu item
# The student uses the enter key to select the Show post in full discussion menu item

'''Postconditions'''

# The discussion pane displays the discussion that the post is in
# The user’s bowser focus is set to the post that Show post in full discussion was selected for.

====== Student Displays the Search Result and All Replies Using a Keyboard ======

'''Description'''

A student selects to display the search result post and all of its replies using a screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display
# There are discussion in the forum
# There are replies in the forum
# There are replies or discussions that match the search criteria in the forum.
# The user has finished searching via advanced search or simple search.

'''Steps'''

# The student uses the screen readers next header keyboard commands to locate the reply they want to edit.
# The student hits the tab key to tab to the action menu for the discussion
# The student uses the spacebar to open the action menu
# The student uses the down arrow to select the Show post and its replies menu item
# The student uses the enter key to select the Show post and its replies menu item

'''Postconditions'''

# The discussion pane displays the post and all of its sub replies
# The user’s bowser focus is set to the post that Show post and its replies was selected for.

==== Accessible Forum Display Forum and Discussion Pane ====

===== Description =====

The forum and discussion pane is designed to provide the user with quick access to overall activity within the forum. This is where the user quickly navigates to the discussion or reply they want to view in the discussion pane.

===== Requirements =====

# The Forum and discussion pane will display the following: (See [[#ForumandDiscussionPane|Mockup: Forum and Discussion Pane]])
## A drop down list of all forums in the course with the current forum selected
## A button to ''Add a new discussion topic''
## If visible or separate groups is set for the forum a statement of the setting will display below the forum select box. See [[#ForumandDiscussionPaneSeparateGroups|Mockup: Forum and Discussion Pane Separate Groups]] and [[#ForumandDiscussionPaneVisibleGroups|Mockup: Forum and Discussion Pane Visible Groups]]
## An expandable collapsable list of all discussions and replies in the currently selected forum the user can view.
# The forum selector drop down will not appear if there is only one forum in the course
# The forum selector will list all advanced forums in the course in alphabetical order
# Selecting a forum from the forum drop down will reload the page as if the user had clicked on the forum in the course.
# The ''Add a new discussion topic'' button will not appear for users if they do not have permissions to create a discussion.
# Clicking the ''Add a new discussion topic'' will display the ''Your new discussion topic'' modal. See [[#NewDiscussionTopicModal|Mockup: New Discussion Topic Modal]]
# Clicking the ''Post to forum'' button in the ''Your new discussion topic'' modal cause the following to happen:
## Save the discussion to the forum
## Add the discussion in the correct sort order to the discussion tree
## Place the browser focus on the discussion tree.
# The ''Your new discussion topic'' modal will lock the user’s focus in the modal
# Clicking the ''Close'' image will close the modal and the user’s focus will return to the forum and discussion pane.
# Clicking the ''Cancel'' button will close the modal and the user’s focus will return to the forum and discussion pane.
# The user will use tab to navigate between the forum selector, add a new discussion topic button and discussion tree.
# A group selector option will display below the mail now form field if a forum is set to separate or visible groups.
# The user will use the up and down arrows to navigate up and down in the discussion tree. See [[#ForumandDiscussionPaneExpanded|Mockup: Forum and Discussion Pane Expanded]]
# The user will use the left and right arrows to expand and contract the discussion tree. See [[#ForumandDiscussionPaneExpanded|Mockup: Forum and Discussion Pane Expanded]]
# The user will be able to use the mouse to click on the + and - images to expand and contract discussions and replies. See [[#ForumandDiscussionPaneExpanded|Mockup: Forum and Discussion Pane Expanded]]
# Discussions that are collapsed and have replies will have a + image to the left of the discussion title and the screen reader will read that the discussion is collapsed. See [[#ForumandDiscussionPaneExpanded|Mockup: Forum and Discussion Pane Expanded]]
# Replies that are collapsed and have replies will have a + image to the left of the reply title and the screen reader will read that the reply is collapsed. See [[#ForumandDiscussionPaneExpanded|Mockup: Forum and Discussion Pane Expanded]]
# Discussions that are expanded and have replies will have a - image to the left of the discussion title and the screen reader will read that the discussion is expanded. See [[#ForumandDiscussionPaneExpanded|Mockup: Forum and Discussion Pane Expanded]]
# Replies that are expanded and have replies will have a - image to the left of the reply title and the screen reader will read that the reply is expanded. See [[#ForumandDiscussionPaneExpanded|Mockup: Forum and Discussion Pane Expanded]]
# When expanded a discussion or reply will display all replies to the discussion in tree form below it. See [[#ForumandDiscussionPaneExpanded|Mockup: Forum and Discussion Pane Expanded]]
# If a discussion or reply has no replies to it then no image will display to the left of the title. See [[#ForumandDiscussionPaneExpanded|Mockup: Forum and Discussion Pane Expanded]]
# Users will use the enter key on a discussion to display the discussion and all replies in the discussion pane. See [[#DiscussionAccessibleDisplay|Mockup: Discussion Accessible Display]]
# Users will click on a discussion to display the discussion and all replies in the discussion pane. See [[#DiscussionAccessibleDisplay|Mockup: Discussion Accessible Display]]
# Users will use the enter key on a reply to display the reply and all replies to the reply in the discussion pane. See [[#SelectedReplyAccessibleDisplay|Mockup: Selected Reply Accessible Display]]
# Users will click on a reply to display the replies and all replies to the reply in the discussion pane. See [[#SelectedReplyAccessibleDisplay|Mockup: Selected Reply Accessible Display]]
# Clicking on a reply or discussion will place the user’s browser focus on the discussion pane
# Hitting the enter key on a discussion or reply link will place the user’s browser focus on the discussion pane.
# The discussion tree will display the number of unread replies for the discussion/reply to the right of the discussion/reply title if the user has read tracking enabled. See [[#ForumandDiscussionPane|Mockup: Forum and Discussion Pane]]
# Forums set to visible or separate groups will add the for and group name to the right of the discussion title when the post is set to a specific group in the discussion tree view. See [[#ForumandDiscussionPaneSeparateGroups|Mockup: Forum and Discussion Pane Separate Groups]] and [[#ForumandDiscussionPaneVisibleGroups|Mockup: Forum and Discussion Pane Visible Groups]]

===== Mockups =====

====== Forum and Discussion Pane ======

[[Image:afForumDiscussionPane.png|afForumDiscussionPane.png]]

====== Forum and Discussion Pane Expanded ======

[[Image:afForumDiscussionPaneExpanded.png|afForumDiscussionPaneExpanded.png]]

====== Forum and Discussion Pane Separate Groups ======

[[Image:afForumDiscussionPaneSeparateGroups.png|afForumDiscussionPaneSeparateGroups.png]]

====== Forum and Discussion Pane Visible Groups ======

[[Image:afForumDiscussionPaneVisibleGroups.png|afForumDiscussionPaneVisibleGroups.png]]

====== Discussion Accessible Display ======

[[Image:afAccessibleDiscussionDisplay.png|afAccessibleDiscussionDisplay.png]]

====== Selected Reply Accessible Display ======

[[Image:afAccessibleReplyDisplay.png|afAccessibleReplyDisplay.png]]

====== New Discussion Topic Modal ======

[[Image:afNewTopicModal.png|afNewTopicModal.png]]

===== Use Cases =====

====== Student Uses a Keyboard to Navigate Between Forum and Discussion Panel Areas ======

'''Description'''

A student navigates between the forum selector, add a new discussion topic and the discussion tree using a screen reader and their keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the F6 key to get to the filter pane
# The student uses the F6 key to get to the forum and discussion pane
# The student uses the tab key to navigate between the areas of the forum and discussion pane

'''Postconditions'''

# The student is able to navigate between the forum selector and discussion tree areas
# The student with the use of the screen reader understands the areas they are navigating between.

====== Student Selects a Different Forum Using a Keyboard ======

'''Description'''

A student navigates to a different forum without going back to the course page using a screen reader and their keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display
# The is more than one forum in the course

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the F6 key to get to the filter pane
# The student uses the F6 key to get to the forum and discussion pane
# The student tabs to the forum selector
# The student uses the spacebar to open the forum selector
# The student uses the down arrow to select the next forum in the course
# The student hits the enter key to select the forum

'''Postconditions'''

# The page is reloaded and the student is in the accessible view of the selected forum.

====== Teacher Adds a New Discussion Topic Using a Keyboard ======

'''Description'''

A teacher with a visual disability adds a new discussion topic to the forum using their screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a teacher
# An advanced forum has been created in the course
# The teacher has navigated to the course
# The teacher is using a screen reader
# The teacher has set the accessible forum display

'''Steps'''

# The teacher uses the screen reader to skip to the main content of the course
# The teacher tabs to the forum activity within the course
# The teacher hits the enter key
# The teacher uses the F6 key to get to the filter pane
# The teacher uses the F6 key to get to the forum and discussion pane
# The teacher uses the tab key to navigate to the ''Add a new discussion topic'' button
# The teacher hit the enter key
# The teacher uses tab to fill in all field in the ''Your new discussion topic modal''
# The teacher tabs to the ''Post to forum'' button
# The teacher hits the enter key

'''Postconditions'''

# The teacher’s post is saved
# The teacher’s browser focus is placed back on the forum and discussion pane.
# The discussion tree is updated with the new discussion.

====== Teacher Adds a New Discussion Topic For a Specific Group Using a Keyboard ======

'''Description'''

A teacher with a visual disability adds a new discussion topic to the forum using their screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a teacher
# An advanced forum has been created in the course
# The teacher has navigated to the course
# The teacher is using a screen reader
# The teacher has set the accessible forum display
# The advanced forum is set to separate groups

'''Steps'''

# The teacher uses the screen reader to skip to the main content of the course
# The teacher tabs to the forum activity within the course
# The teacher hits the enter key
# The teacher uses the F6 key to get to the filter pane
# The teacher uses the F6 key to get to the forum and discussion pane
# The teacher uses the tab key to navigate to the ''Add a new discussion topic'' button
# The teacher hit the enter key
# The teacher uses tab to fill in all field in the ''Your new discussion topic modal''
# The teacher selects a specific group from the group selector
# The teacher tabs to the ''Post to forum'' button
# The teacher hits the enter key

'''Postconditions'''

# The teacher’s post is saved
# The teacher’s browser focus is placed back on the forum and discussion pane.
# The discussion tree is updated with the new discussion.
# The discussion title has the words for <group name selected> to its right.

====== Teacher Keyboard is Locked in the Your New Discussion Topic Modal ======

'''Description'''

A teacher with a visual disability tabs through all live areas in the Your new discussion topic modal and can’t exist the modal until they hit enter for the close or cancel buttons.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a teacher
# An advanced forum has been created in the course
# The teacher has navigated to the course
# The teacher is using a screen reader
# The teacher has set the accessible forum display

'''Steps'''

# The teacher uses the screen reader to skip to the main content of the course
# The teacher tabs to the forum activity within the course
# The teacher hits the enter key
# The teacher uses the F6 key to get to the filter pane
# The teacher uses the F6 key to get to the forum and discussion pane
# The teacher uses the tab key to navigate to the ''Add a new discussion topic'' button
# The teacher hit the enter key
# The teacher hits the tab until they have listened to all fields in the modal
# The teacher hits tab until they find the close button

'''Postconditions'''

# The teacher’s keyboard focus is locked within the modal until they hit enter on the close or cancel buttons.

====== Student Expands a Discussion Using a Keyboard ======

'''Description'''

A student expands a discussion to listen to all of the replies to the discussion using a screen reader and their keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display
# More than one discussion has been created
# Replies have been posted to discussions

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the F6 key to get to the filter pane
# The student uses the F6 key to get to the forum and discussion pane
# The student uses the tab key to navigate to the discussion tree
# The student uses the left arrow key to expand the replies to the discussion

'''Postconditions'''

# All the titles for the replies of reply depth 1 for the discussion are showing and read to the user via the screen reader

====== Student Expands a Discussion Using a Mouse ======

'''Description'''

A student expands the replies to a discussion using their mouse.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student has set the accessible forum display
# More than one discussion has been created
# Replies have been posted to discussions

'''Steps'''

# The student clicks on the forum in the course
# The student clicks on the plus image to the left of the discussion title

'''Postconditions'''

# All the titles for the replies of reply depth 1 for the discussion are displayed

====== Student Navigated Down the Discussion Tree Using a Keyboard ======

'''Description'''

A student navigates to a reply to a discussion using a screen reader and their keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display
# More than one discussion has been created
# Replies have been posted to discussions

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the F6 key to get to the filter pane
# The student uses the F6 key to get to the forum and discussion pane
# The student uses the tab key to navigate to the discussion tree
# The student uses the down arrow to navigate to the next discussion in the tree

'''Postconditions'''

# The title of the discussion is read to the student via the screen reader

====== Student Selects a Discussion to Display Using a Keyboard ======

'''Description'''

A student selects a discussion using a screen reader and their keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display
# More than one discussion has been created
# Replies have been posted to discussions

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the F6 key to get to the filter pane
# The student uses the F6 key to get to the forum and discussion pane
# The student uses the tab key to navigate to the discussion tree
# The student uses the down arrow to navigate to the next discussion
# The student hits the enter key

'''Postconditions'''

# The student’s browser focus is set to the discussion pane
# The discussion pane is updated to display the full discussion plus all replies in the discussion.

====== Student Selects a Discussion Using a Mouse ======

'''Description'''

A student selects a discussion using their mouse.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student has set the accessible forum display
# More than one discussion has been created
# Replies have been posted to discussions

'''Steps'''

# The student clicks on the forum in the course
# The student clicks on the discussion title

'''Postconditions'''

# The student’s browser focus is set to the discussion pane
# The discussion pane is updated to display the full discussion plus all replies in the discussion.

====== Student Locates a Discussion With Unread Replies using a Keyboard ======

'''Description'''

A student navigates through the discussion tree until they hear a discussion that has new replies to it. The student is using the screen reader and their keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display
# More than one discussion has been created
# Replies have been posted to discussions

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the F6 key to get to the filter pane
# The student uses the F6 key to get to the forum and discussion pane
# The student uses the down arrow to located a discussion with unread replies

'''Postconditions'''

# Each discussion title is read as the user uses the down arrow to navigate down
# The discussion title is read then the number of unread replies.

====== Student Selects a Reply Using a Keyboard ======

'''Description'''

A student navigates to a reply and selects it to listen to in the discussion pane using a screen reader and their keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student is using a screen reader
# The student has set the accessible forum display
# More than one discussion has been created
# Replies have been posted to discussions

'''Steps'''

# The student uses the screen reader to skip to the main content of the course
# The student tabs to the forum activity within the course
# The student hits the enter key
# The student uses the F6 key to get to the filter pane
# The student uses the F6 key to get to the forum and discussion pane
# The student uses the right arrow to expand a discussion
# The student hits the enter key

'''Postconditions'''

# The student’s browser focus is set to the discussion pane
# The discussion pane is updated to display the reply and all replies of a reply depth below the starting reply.

====== Student Selects a Reply Using a Mouse ======

'''Description'''

A student navigates to a reply and selects it to listen to in the discussion pane using their mouse.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the course
# The student has set the accessible forum display
# More than one discussion has been created
# Replies have been posted to discussions

'''Steps'''

# The student clicks on the forum in the course
# The student clicks on the plus image to the left of the discussion title
# The student clicks on the reply title

'''Postconditions'''

# The student’s browser focus is set to the discussion pane
# The discussion pane is updated to display the reply and all replies of a reply depth below the starting reply.

==== Accessible Forum Discussion Display Pane ====

===== Description =====

The discussion display pane is the region of the forum that displays to the user the specific discussion or reply they have chosen with all sub replies. The pane is designed to present the selected discussion or reply in the most accessible manner focusing on simplified content and easy tabbing between actions. HTML headers are used to help inform the user where they are in the hierarchy of the discussion.

{note}It is understood that using HTML header’s to denote the hierarchy of the forum has the issue that HTML only has a header level up to H6. Furthermore H1 is only used once on a page and for the page heading. This is why the maximum reply depth setting has been added. It also should be noted that after a reply depth of 3 forum replies become less focused on the original discussion topic.{note}

===== Requirements =====

# The discussion pane will be separated into 2 areas: (See [[#DiscussionDisplayPaneStructure|Mockup: Discussion Display Pane Structure]])
## Message display area. This is a live area that is updated with message as information is added or removed via modals.
## Discussion/reply display area. This is dynamically updated based on modals and the forum and discussion pane.
# Messages in the message area will display for 30 seconds and then be removed from the page.
# The message output area will not be accessible if there are no messages.
# Each discussion or reply will be separated into 3 areas: (See [[#Discussion/ReplyStructure|Mockup: Discussion/Reply Structure]])
## Heading
## Post
### Post text
### File attachments
## Actions
# A discussion/reply heading will display the following information in this order: (See [[#TeacherViewsOwnDiscussion|Mockup: Teacher Views Own Discussion]])
## Post title using the correct HTML header based on reply depth (see below)
## Author with their image and name, the image will not be identified to a screen reader
## Post date, the date the post was created
## Rating type and value (this will only display if ratings are enabled)
# The accessible display mode will use HTML header tags for the title of the discussion post and replies. See [[#DiscussionAccessibleDisplay|Mockup: Discussion Accessible Display]]
# The discussion post will use a h2 HTML header tag for the title of the post. See [[#DiscussionAccessibleDisplay|Mockup: Discussion Accessible Display]]
# A replies reply depth will determine the HTML header tag to be used for the title: (See [[#DiscussionAccessibleDisplay|Mockup: Discussion Accessible Display]])
## Reply depth 1 will use the HTML header h3
## Reply depth 2 will use the HTML header h4
## Reply depth 3 will use the HTML header h5
## Reply depth 4 will use the HTML header h6
# Forums that allow a reply depth greater then 4 will use the HTML Header tag of H6 for all reply titles at a depth of 4 or greater.
# The post text area will display the post text and then any file attachments in an un ordered list below the. See [[#Discussion/ReplyStructure|Mockup: Discussion/Reply Structure]]
# If there are no actions available to the user then the action area will not display
# When the forum is set to separate groups and a discussion is set to all participants the action area will not display to students.
# Replies in the discussion pane will display based on the reply hierarchy and depth.
# If the teacher is the creator of the discussion or reply their name will be denoted in bold and the screen reader will read “Teacher” before reading the poster’s name.
# Anywhere in the below action menus if the action is subscribe it will be replaced with unsubscribe if the user is already subscribed to the discussion.
# Anywhere in the below action menus if the action bookmark is available the option remove bookmark will show if the discussion or reply is already bookmarked
# Anywhere in the below action menus if the action mark substantive is available the option Unmark substantive will show if the discussion or reply is already marked as substantive.
# Reply will display in the below action menus only if the user has permissions to create a reply
# Rating and view ratings will only display in the below action menus if the rating setting is enabled for the forum.
# A teacher will have the following actions available when viewing their own discussion: (See [[#TeacherViewsOwnDiscussion|Mockup: Teacher Views Own Discussion]])
## Edit
## Delete
## View ratings (only displays if ratings are enabled for the forum)
## Subscribe (will not display if subscribed to the forum or forum subscription is disabled)
## Mark substantive
## Bookmark
## Reply
# A teacher will have the following actions available when viewing their own reply: (See [[#TeacherViewsTeacherReply|Mockup: Teacher Views Teacher Reply]])
## Edit
## Split
## Delete
## View ratings (only displays if ratings are enabled for the forum)
## Mark substantive
## Bookmark
## Reply
# A teacher will have the following actions available when viewing a student’s reply: (See [[#TeacherViewsStudentReply|Mockup: Teacher Views Student Reply]])
## Reply
## Split
## Delete
## Rate (only displays if ratings are enabled for the forum)
## Mark substantive
## Bookmark
# A student will have the following actions available when viewing a discussion: (See [[#StudentViewsDiscussion|Mockup: Student Views Discussion]])
## Reply
## Rate
## Subscribe
# A student will have the following actions available when viewing their own reply: (See [[#StudentViewsOwnReply|Mockup: Student Views Own Reply]])
## Edit
## Delete
## Reply
# A private reply will display only to the student who created the original reply and the teachers.
# A teacher will have the following options available when viewing a private reply: (See [[#TeacherViewPrivateReply|Mockup: Teacher View Private Reply]])
## Edit
## Split
## Delete
# The action area will not display to a student for a private reply. See ([[#AnonymousReply|Mockup: Anonymous Reply]])
# The user’s picture will display as the default user picture for an anonymous forum. See ([[#AnonymousReply|Mockup: Anonymous Reply]])
# The user’s name will appear as a Anonymous user instead of the creators real name.
# A user will have all the same action menu options for an anonymous reply as they would for a reply of the same type in a regular forum.
# A user will be able to use the spacebar to open the action menu
# A user will be able to tab to an action menu
# A user will be able to use the enter key to select an action menu item.
# Selecting the reply action will bring up the reply modal.
# The student reply modal will have the fields in [[#StudentReplyModal|Mockup: Student Reply Modal]]
# The file upload area will not display if the forum is set to not allow attachments.
# The teacher reply modal will have additional form fields compared to a student’s reply modal based on the type of forum and the forum settings:See ([[#TeacherReplyModal|Mockup: Teacher Reply Modal]])
## Mail now
## Group (select box with available groups if the forum is set to visible or separate groups)
## Private reply
## Reveal yourself in this post (if the forum is set to anonymous)
# The reply modal will lock the user’s keyboard in the modal until the user clicks the ''Close'', ''Cancel'', or ''Post to forum'' button.
# Clicking the ''Post to forum'' button will cause the following things to happen:
## The reply is added as a reply to the discussion
## The modal closes
## The reply displays inline in the discussion/reply hierarchy
## Add a message to the message output area stating that the reply was successfully created and that the user has 30 minutes to edit the post.
## The message will be followed by a link to jump to the reply in the discussion display pane.
## The user’s browser focus is placed on the successful creation message.
# Selecting the split action will bring up the split post modal. See ([[#SplitPostModal|Mockup: Split Post Modal]])
# The split post modal will key the keyboard locked in the modal until the user clicks the ''Close'', ''Cancel'', or ''Split'' button.
# Clicking the ''Split'' button will cause the following things to happen:
## The Split post modal to close
## The Post and all of the replies to it or lower in the reply hierarchy to be converted to a discussion
## The post converted to the initial discussion post for the new discussion with the title in the new discussion title field of the modal
## A message to be added to the message display area stating that the post was successfully split and is displayed below.
## The discussion display pane will display the new discussion that the post was split into.
## The discussion tree in the forum and discussion pane is updated to reflect the changes to the forum.
# Selecting the delete action will bring up a conformation that the user wants to delete the reply or discussion. See ([[#DeleteReplyModal|Mockup: Delete Reply Modal]])
# Clicking the ''Delete post'' button will do the following things:
## Close the modal
## Remove the post and all of the replies lower in the hierarchy than the post.
## Add a successfully deleted message to the message output area.
## Place the user’s browser focus on the success message.
# The delete post modal will key the keyboard locked in the modal until the user clicks the ''Close'', ''Cancel'', or ''Delete post'' button.
# Selecting the edit action will bring up the reply modal pre-populated with the post that is being edited. See ([[#EditReplyModal|Mockup: Edit Reply Modal]])
# Selecting the rate action will bring up the rate modal pre-populated with the current rating the user has given the post. See [[#RatingModal|Mockup: Rating Modal]]
# The rate post modal will key the keyboard locked in the modal until the user clicks the ''Close'', ''Cancel'', or ''Rate post'' button.
# Clicking the rate button will cause the following things to happen:
## The rate post modal will close
## The rating the user had entered will be saved for the post
## The rating for the post will update based on the forum settings.
## A message will be printed in the message output area stating that the rating was successfully saved with a link to jump back to the post within the discussion display panel.
# Selecting the view ratings action will bring up the view ratings modal. See ([[#ViewRatingsModal|Mockup: View Ratings Modal]])
# The view ratings modal will keep the user’s keyboard focus until the user clicking on the ''Close'' or ''Close this window'' button.
# Closing a modal using the ''Close'', ''Close this window'' or ''Cancel'' buttons will place the user’s browser focus back on the action menu the user was on when they opened the modal.
# Any errors in the processing of a modal will display an error message in the message output area with a link back to the area the user was in when the error occurred.
# Selecting the subscribe action will do the following things:
## Subscribe the user to the discussion to receive emails when new replies are created in the discussion
## Display a message in the message output stating that the user has been subscribed to the discussion
## Place the user’s browser focus on the message output.
# Selecting the unsubscribe action will do the following things:
## Unsubscribe the user from the discussion and cause the user to stop receiving emails when new replies are created in the discussion
## Display a message in the message output stating that the user has been unsubscribed to the discussion
## Place the user’s browser focus on the message output.
# Selecting the bookmark action will do the following things:
## Add the bookmark flag to the post
## Display a message in the message output stating that the post was bookmarked
## The message will end with a link to jump to the post that was bookmarked.
## Place the user’s browser focus on the message output
# Selecting the Remove bookmark action will do the following things:
## Remove the bookmark flag from the post
## Display a message in the message output stating that the bookmark has been removed from the post
## The message will end with a link to jump to the post that the bookmark was removed from.
## Place the user’s browser focus on the message output
## The message will end with a link to jump to the post that the bookmark was removed from.
# Selecting the Mark substantive action will do the following things:
## Add the substantive flag to the post
## Display a message in the message output stating that the post was flagged as substantive
## The message will end with a link to jump to the post that was flagged as substantive
## Place the user’s browser focus on the message output
# Selecting the Remove substantive mark action will do the following things:
## Remove the substantive flag from the post
## Display a message in the message output stating that the substantive flag was removed from the post
## The message will end with a link to jump to the post the substantive flag was removed from.
## Place the user’s browser focus on the message output

===== Mockups =====

====== Discussion Display Pane Structure ======

[[Image:afDiscussionDisplayPaneStructure.png|afDiscussionDisplayPaneStructure.png]]

====== Discussion/Reply Structure ======

[[Image:afReplyStructure.png|afReplyStructure.png]]

====== Teacher Views Own Discussion ======

[[Image:afTeacherViewOwnDiscussion.png|afTeacherViewOwnDiscussion.png]]

====== Teacher Views Teacher Reply ======

[[Image:afTeacherViewTeacherReply.png|afTeacherViewTeacherReply.png]]

====== Teacher Views Student Reply ======

[[Image:afTeacherViewStudentReply.png|afTeacherViewStudentReply.png]]

====== Student Views Discussion ======

[[Image:afStudentViewDiscussion.png|afStudentViewDiscussion.png]]

====== Student Views Own Reply ======

[[Image:afStudentViewOwnReply.png|afStudentViewOwnReply.png]]

====== Teacher View Private Reply ======

[[Image:afPrivateReply.png|afPrivateReply.png]]

====== Anonymous Reply ======

[[Image:afAnonymousReply.png|afAnonymousReply.png]]

====== Student Reply Modal ======

[[Image:afStudentReplyModal.png|afStudentReplyModal.png]]

====== Teacher Reply Modal ======

[[Image:afTeacherReplyModal.png|afTeacherReplyModal.png]]

====== Rating Modal ======

[[Image:afRatingModal.png|afRatingModal.png]]

====== Split Post Modal ======

[[Image:afSplitModal.png|afSplitModal.png]]

====== Delete Post Modal ======

[[Image:afDeletePostModal.png|afDeletePostModal.png]]

====== Edit Reply Modal ======

[[Image:afEditModal.png|afEditModal.png]]

====== View Ratings Modal ======

[[Image:afViewRatingsModal.png|afViewRatingsModal.png]]

===== Use Cases =====

====== Student Listens to a Discussion Created by a Teacher ======

'''Description'''

A student selects a discussion using a screen reader and keyboard and listens to the screen reader read the discussion post.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the forum
# The student is using a screen reader
# The student has set the accessible forum display
# More than one discussion has been created by the teacher
# Replies have been posted to discussions

'''Steps'''

# The student uses the F6 key to get to the filter pane
# The student uses the F6 key to get to the forum and discussion pane
# The student uses the enter key to select the discussion

'''Postconditions'''

# The student is able to identify that the teacher created the discussion and not just another student.

====== Student Navigates Between Replies to a Discussion Using a Keyboard ======

'''Description'''

A student navigates between reply headings using the screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the forum
# The student is using a screen reader
# The student has set the accessible forum display
# More than one discussion has been created by the teacher
# The student has made a reply to a discussion

'''Steps'''

# The student uses the F6 key to get to the filter pane
# The student uses the F6 key to get to the forum and discussion pane
# The student uses the enter key to select the discussion
# The student uses the screen readers next header function to locate the next reply

'''Postconditions'''

# The student can identify by the header where they are within the forum hierarchy.
# The student is able to quickly navigate to each reply

====== Student Replies to a Discussion Using a Keyboard ======

'''Description'''

A student creates a reply to a discussion using a screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the forum
# The student is using a screen reader
# The student has set the accessible forum display
# More than one discussion has been created by the teacher
# Replies have been posted to discussions

'''Steps'''

# The student uses the F6 key to get to the filter pane
# The student uses the F6 key to get to the forum and discussion pane
# The student uses the enter key to select the discussion
# The student hits the tab key to tab to the action menu for the discussion
# The student hits the spacebar to open the action menu
# The student uses the down arrow to navigate to the reply action
# The student hits the enter key
# The student uses the tab key to tab through the forum fields and enter a reply
# The student tabs to the Post to forum button
# The student hits the enter key

'''Postconditions'''

# The reply is added to the discussion display pane in the proper place
# A message is displayed in the message output area
# The student hears the message

====== Student Edits a Reply Using a Keyboard ======

'''Description'''

A student edits a reply they have made using a screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the forum
# The student is using a screen reader
# The student has set the accessible forum display
# More than one discussion has been created by the teacher
# The student has made a reply to a discussion

'''Steps'''

# The student uses the F6 key to get to the filter pane
# The student uses the F6 key to get to the forum and discussion pane
# The student uses the enter key to select the discussion
# The student uses the screen readers next header keyboard commands to locate the reply they want to edit.
# The student hits the tab key to tab to the action menu for the discussion
# The student uses the spacebar to open the action menu
# The student uses the down arrow to select the edit menu item
# The student uses the enter key to select the edit menu item
# The student uses the tab key to navigate to the field they want to change
# The student uses the tab key to navigate to the ''Post to forum'' button
# The student hits the enter key to post the edits to the forum

'''Postconditions'''

# The reply is updated in the discussion display pane in the proper place
# A message is displayed in the message output area stating that the reply has been created and allowing the student to jump to the new reply.
# The student hears the message

====== Student’s Keyboard Stays Locked in the Reply Modal ======

'''Description'''

A student tabs through all of the options in the reply modal twice using a screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the forum
# The student is using a screen reader
# The student has set the accessible forum display
# More than one discussion has been created by the teacher
# The student has made a reply to a discussion

'''Steps'''

# The student uses the F6 key to get to the filter pane
# The student uses the F6 key to get to the forum and discussion pane
# The student uses the enter key to select the discussion
# The student uses the screen readers next header keyboard commands to locate the reply they want to reply to.
# The student hits the tab key to tab to the action menu for the discussion
# The student uses the spacebar to open the action menu
# The student uses the down arrow to select the edit menu item
# The student uses the enter key to select the edit menu item
# The student uses the tab key to navigate through all the modal fields twice

'''Postconditions'''

# The user always tabs within the modal and the keyboard focus never leaves the modal.

====== Student Jumps to a Newly Created Reply ======

'''Description'''

A student jumps to the reply they have made using a screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the forum
# The student is using a screen reader
# The student has set the accessible forum display
# More than one discussion has been created by the teacher
# The student has made a reply to a discussion

'''Steps'''

# The student uses the F6 key to get to the filter pane
# The student uses the F6 key to get to the forum and discussion pane
# The student uses the enter key to select the discussion
# The student uses the screen readers next header keyboard commands to locate the reply they want to reply to.
# The student hits the tab key to tab to the action menu for the discussion
# The student uses the spacebar to open the action menu
# The student uses the down arrow to select the edit menu item
# The student uses the enter key to select the edit menu item
# The student uses the tab key to fill out all the fields in the forum
# The student uses the tab key to navigate to the ''Post to forum'' button
# The student hits the enter key to post the reply to the forum
# The student hits the enter key when the screen reader reads the link to jump to the newly created reply

'''Postconditions'''

# The user’s browser focus is placed on the header for the reply they just created.

====== Student Subscribes to a Discussion Using a Keyboard ======

'''Description'''

A student subscribes to a discussion using a screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the forum
# The student is using a screen reader
# The student has set the accessible forum display
# More than one discussion has been created by the teacher
# The forum is set to optional forum subscriptions.
# The student is not subscribed to the forum
# The student has not subscribed to the discussion

'''Steps'''

# The student uses the F6 key to get to the filter pane
# The student uses the F6 key to get to the forum and discussion pane
# The student uses the enter key to select the discussion
# The student uses the screen readers next header keyboard commands to locate the reply they want to subscribe to.
# The student hits the tab key to tab to the action menu for the discussion
# The student uses the spacebar to open the action menu
# The student uses the down arrow to select the subscribe menu item
# The student uses the enter key to select the subscribe menu item

'''Postconditions'''

# The student is subscribed to the discussion
# A message is displayed in the message output area stating that the student has been subscribed to the discussion.
# The student hears the message

====== Student Accesses a Discussion’s Action Menu Using a Mouse ======

'''Description'''

A student displays a discussion’s action menu using a mouse.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a student
# An advanced forum has been created in the course
# The student has navigated to the forum
# The student is using a screen reader
# The student has set the accessible forum display
# More than one discussion has been created by the teacher

'''Steps'''

# The student clicks on the discussion
# The student clicks on the action menu for the discussion

'''Postconditions'''

# The action menu expands

====== Teacher Rates a Post Using a Keyboard ======

'''Description'''

A teacher rates a student’s post using a screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a teacher
# An advanced forum has been created in the course
# The teacher has navigated to the course
# The teacher is using a screen reader
# The teacher has set the accessible forum display
# The teacher has created a discussion
# A student has made a reply to a discussion
# The forum is set to allow rating
# The student reply has not been rated

'''Steps'''

# The teacher uses the F6 key to get to the filter pane
# The teacher uses the F6 key to get to the forum and discussion pane
# The teacher uses the enter key to select the discussion
# The teacher uses the screen readers next header keyboard commands to locate the reply they want to rate.
# The teacher hits the tab key to tab to the action menu for the discussion
# The teacher uses the spacebar to open the action menu
# The teacher uses the down arrow to select the rate menu item
# The teacher uses the enter key to select the rate menu item
# The teacher uses the spacebar to open the rating select box
# The teacher uses the down arrow to select the rating they want.
# The teacher hits the enter key to select the rating for the post
# The teacher uses the tab key to navigate to the rate button.
# The teacher uses the enter key to rate the post.

'''Postconditions'''

# The post is rated
# The post’s rating is recalculated
# A message is displayed in the message output area stating that the post has been rated and allowing the teacher to jump to the post they rated.
# The student hears the message

====== Teacher Deletes a Discussion Using a Keyboard ======

'''Description'''

A teacher deletes a discussion using a screen reader and keyboard

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a teacher
# An advanced forum has been created in the course
# The teacher has navigated to the course
# The teacher is using a screen reader
# The teacher has set the accessible forum display
# A discussion has been created in the forum
# A reply has been made to the discussion

'''Steps'''

# The teacher uses the F6 key to get to the filter pane
# The teacher uses the F6 key to get to the forum and discussion pane
# The teacher uses the enter key to select the discussion
# The teacher hits the tab key to tab to the action menu for the discussion
# The teacher uses the spacebar to open the action menu
# The teacher uses the down arrow to select the delete menu item
# The teacher uses the enter key to select the delete menu item
# The teacher uses the spacebar to open the delete select box
# The teacher listens to the modal window text
# The teacher uses the tab key to navigate to the delete post button.
# The teacher uses the enter key to delete post button to delete the post.

'''Postconditions'''

# The post is deleted
# A message is displayed in the message output area stating that the post has been deleted and allowing the teacher to jump back to the forum and discussion pane
# The student hears the message

====== Teacher the Views Ratings for a Post Using a Keyboard ======

'''Description'''

A teacher views the ratings that have been given for a student’s post using a screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a teacher
# An advanced forum has been created in the course
# The teacher has navigated to the course
# The teacher is using a screen reader
# The teacher has set the accessible forum display
# The teacher has created a discussion
# A student has made a reply to a discussion
# The teacher and others have rated a student’s reply

'''Steps'''

# The teacher uses the F6 key to get to the filter pane
# The teacher uses the F6 key to get to the forum and discussion pane
# The teacher uses the enter key to select the discussion
# The teacher uses the screen readers next header keyboard commands to locate the reply they want to view the ratings for.
# The teacher hits the tab key to tab to the action menu for the discussion
# The teacher uses the spacebar to open the action menu
# The teacher uses the down arrow to select the view ratings menu item
# The teacher uses the enter key to select the view ratings menu item

'''Postconditions'''

# The view ratings modal appears with all the ratings that have been submitted for the post.

====== Teacher Splits a Reply Using a Keyboard ======

'''Description'''

A teacher splits a reply into a new discussion using a screen reader and keyboard

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a teacher
# An advanced forum has been created in the course
# The teacher has navigated to the course
# The teacher is using a screen reader
# The teacher has set the accessible forum display
# The teacher has created a discussion
# The reply has multiple replies to it.

'''Steps'''

# The teacher uses the F6 key to get to the filter pane
# The teacher uses the F6 key to get to the forum and discussion pane
# The teacher uses the enter key to select the discussion
# The teacher uses the screen readers next header keyboard commands to locate the reply they want to split.
# The teacher hits the tab key to tab to the action menu for the discussion
# The teacher uses the spacebar to open the action menu
# The teacher uses the down arrow to select the split menu item
# The teacher uses the enter key to select the split menu item
# The teacher uses the tab key to tab to the new discussion title field and enters a discussion title
# The teacher tabs to the split button
# The teacher hits the enter key to split the reply

'''Postconditions'''

# A new discussion is created from the reply with the title provided in the new discussion title field
# A message appears in the message output area that states the reply was split.
# The teacher’s browser focus is set to the message output
# The discussion display pane shows the newly created discussion
# The discussion tree in the forum and discussion pane is updated with the new discussion.

====== Teacher Marks a Post as Substantive Using a Keyboard ======

'''Description'''

A teacher marks a post as substantive using a screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a teacher
# An advanced forum has been created in the course
# The teacher has navigated to the course
# The teacher is using a screen reader
# The teacher has set the accessible forum display
# The teacher has created a discussion
# A student has made a reply to a discussion

'''Steps'''

# The teacher uses the F6 key to get to the filter pane
# The teacher uses the F6 key to get to the forum and discussion pane
# The teacher uses the enter key to select the discussion
# The teacher uses the screen readers next header keyboard commands to locate the reply they want mark as substantive.
# The teacher hits the tab key to tab to the action menu for the discussion
# The teacher uses the spacebar to open the action menu
# The teacher uses the down arrow to select the mark substantive menu item
# The teacher uses the enter key to select the mark substantive menu item

'''Postconditions'''

# The post is marked as substantive
# A message is added to the message output area stating that the post has been marked substantive and a link is included to allow the teacher to jump to the post.
# The teacher’s browser focus is placed on the message output.
# The teacher hears the message read to them.

====== Teacher Bookmarks a Post Using a Keyboard ======

'''Description'''

A teacher bookmarks a post using a screen reader and keyboard.

'''Preconditions'''

# The user is logged in
# The user is enrolled in a course as a teacher
# An advanced forum has been created in the course
# The teacher has navigated to the course
# The teacher is using a screen reader
# The teacher has set the accessible forum display
# The teacher has created a discussion
# A student has made a reply to a discussion

'''Steps'''

# The teacher uses the F6 key to get to the filter pane
# The teacher uses the F6 key to get to the forum and discussion pane
# The teacher uses the enter key to select the discussion
# The teacher uses the screen readers next header keyboard commands to locate the reply they want to view the ratings for.
# The teacher hits the tab key to tab to the action menu for the discussion
# The teacher uses the spacebar to open the action menu
# The teacher uses the down arrow to select the bookmark menu item
# The teacher uses the enter key to select the bookmark menu item

'''Postconditions'''

# The post is flagged as bookmarked
# A message is added to the message output area stating that the post has been bookmarked and a link is included to allow the teacher to jump to the post.
# The teacher’s browser focus is placed on the message output.
# The teacher hears the message read to them.

=== Glossary ===

* {anchor:replydepth} '''Reply depth:''' The hierarchical level that a reply is on. A reply to a discussion is reply depth 1. A reply to a reply is depth 2. A reply to a reply to a reply is depth 3. Example: Discussion (depth 0) Reply (depth 1) Reply 2 (depth 2) Replay 3 (depth 3) Reply 4 (depth 2) Replay 5 (depth 1)

=== Document Change Management ===

==== Revision Summary ====

==== Revision History ====

=== Open Questions ===

==See also==

[https://tracker.moodle.org/browse/MDL-39707]

[[Category: Project]]

File:afViewRatingsModal.png

2013-07-25T00:28:01Z

Psychoph:

File:afEditModal.png

2013-07-25T00:27:46Z

Psychoph:

File:afDeletePostModal.png

2013-07-25T00:27:35Z

Psychoph:

File:afSplitModal.png

2013-07-25T00:26:49Z

Psychoph:

File:afRatingModal.png

2013-07-25T00:26:38Z

Psychoph:

File:afTeacherReplyModal.png

2013-07-25T00:25:53Z

Psychoph:

File:afStudentReplyModal.png

2013-07-25T00:25:35Z

Psychoph:

File:afAnonymousReply.png

2013-07-25T00:25:13Z

Psychoph:

File:afStudentViewOwnReply.png

2013-07-25T00:24:08Z

Psychoph:

File:afStudentViewDiscussion.png

2013-07-25T00:23:05Z

Psychoph:

File:afTeacherViewStudentReply.png

2013-07-25T00:22:15Z

Psychoph:

File:afTeacherViewTeacherReply.png

2013-07-25T00:22:02Z

Psychoph:

File:afTeacherViewOwnDiscussion.png

2013-07-25T00:16:44Z

Psychoph:

File:afReplyStructure.png

2013-07-24T22:44:04Z

Psychoph:

File:afDiscussionDisplayPaneStructure.png

2013-07-24T22:43:35Z

Psychoph:

File:afNewTopicModal.png

2013-07-24T22:26:26Z

Psychoph:

File:afAccessibleReplyDisplay.png

2013-07-24T22:26:18Z

Psychoph:

File:afAccessibleDiscussionDisplay.png

2013-07-24T22:26:02Z

Psychoph:

File:afForumDiscussionPaneVisibleGroups.png

2013-07-24T22:25:29Z

Psychoph:

File:afForumDiscussionPaneSeparateGroups.png

2013-07-24T22:25:19Z

Psychoph:

File:afForumDiscussionPaneExpanded.png

2013-07-24T22:25:08Z

Psychoph:

File:afForumDiscussionPane.png

2013-07-24T22:24:47Z

Psychoph:

File:afAdvancedSearchModal.png

2013-07-24T22:23:29Z

Psychoph:

File:afSearchResults.png

2013-07-24T22:23:17Z

Psychoph:

File:afFilterPaneExpandedStudent.png

2013-07-24T22:22:44Z

Psychoph:

File:afFilterPaneExpandedTeacher.png

2013-07-24T22:22:10Z

Psychoph:

File:afFilterPane.png

2013-07-24T22:21:27Z

Psychoph:

File:afNoDiscussionSelected.png

2013-07-24T22:20:58Z

Psychoph:

File:afAccessibleDisplayStructure.png

2013-07-24T22:20:38Z

Psychoph:

File:afPrivateReply.png

2013-07-24T22:19:58Z

Psychoph:

File:afMaxReplyPrivateReply.png

2013-07-24T22:09:21Z

Psychoph:

File:afMaxReplyDepthDisplay.png

2013-07-24T22:08:55Z

Psychoph: