Brickfield Education Labs

Table of Contents

Introduction

The Fix italics wizard provides you with “italic” errors for the course, or courses and updates the formatting of italic text into the correct HTML tag, from the <i> tag to a <em> tag to help fix them quickly.

 

The <i> (italic) element, or tag, provides no emphasis of text for non-sighted readers. Use the correct <em> tag instead.

 

N.B.: In the top right of the Fix italics wizard is a “Help docs” button that will bring your directly to this documentation page.

Impact of using i instead of em

The <i> (italic) element only conveys appearance, whereas the <em> element conveys meaning to all.

Where to find the Fix italics wizard

The Fix italics wizard can be accessed via:

  • From Site administration: Site administration > Brickfield Enable > Accessibility management > Go to wizards > Fix > Italics.
  • From a course: Course actions menu > More > Brickfield Accessibility+ Toolkit > Fix > Italics.
  • From the course block: Accessibility+ Review block > View Accessibility+ Report (Chart icon) > Fix > Italics.
  • From the Check list report: The “Fix” link that’s available for the “”Italic” (i) elements should not be used, “em” should be used instead” check in the Check list report.

How to use the Fix italics wizard

The Fix italics wizard displays a page which includes a table where each row is one of the italic tags found that is using <i>.

 

The Fix italics wizard provides the ability to:

  • Submit alt text updates for images in bulk.
  • Make an exception by hiding an individual error.
The fix italics wizard displaying the page heading, number of reviewed courses, help docs button, number of errors, and the italic errors table. The italic errors table has 4 columns: details, existing, update to, and hide.

The heading area of the wizard will show how many errors are found, and whether the errors listed are for one course or many courses.

  • If the results are for one course, the course name is displayed.
  • If the results are for more than one course, the number of courses is displayed.

 

The table displays a row for each error that contains four parts:

  • Details
    • Course Name.
    • Course Section.
    • Activity name.
    • The link to Edit the content.
  • Existing context
    • Existing content.
    • The button to view the error in its full context.
  • Update to
    • Existing text.
    • Update to.
  • Hide – The checkbox to hide the error when submitted.

Submit updates for bulk fixing

When updates to the errors are submitted for bulk fixing, it will only process the errors on the current page. All fixed errors are temporarily logged and can be reverted if needed in the Bulk fix log. 

 

To submit updates to the errors for bulk fixing:

  1. Ensure you are viewing the Fix italics wizard.
  2. If you want to hide this error, select the “Hide” checkbox.
  3. Select the “Submit Bulk fixing” button to submit all the updates at once.

 

All hidden errors are located in the Hidden errors page.

Capability requirements

Access to the Brickfield Accessibility+ Toolkit is controlled by capabilities and users must have the correct capabilities in the correct context.

  • ‘tool/bfplus:viewsystemtools’ capability – To view site level reports and wizards.
  • ‘tool/bfplus:viewcoursetools’ capability – To view individual course reports and wizards.
  • ‘accessibilityplustool/fixitalics:view’ capability – To view this Fix italics wizard, users must have this and one of the capabilities mentioned above.

 

For more information, go to: Capabilities.