The Accessible Content Module and the Accessible module

Events happening in the community are now at Drupal community events on www.drupal.org.
kevee_gdo's picture

You all might remember an earlier post I made about the QUAIL accessibility library and its potential for checking content for accessibility. Well, now you can download the fruits of that labor!

There's a readme file in there that outlines how to download and setup the module. It comes packaged with the quail lib for now, but if it goes to drupal.org I'll remove it and require folks to download it from it's own site on code.google.com.

There's some code formatting issues because I have readability issues with some of the formatting requirements Drupal has, but those would be fixed before it went up. It's a little rough around some edges, but I think it's a pretty good start.

The thing I would like to hear from folks here is whether this should be a separate module, or if it should be rolled into the existing Accessible module.

Outline of the module

Accessible Content
Provides accessiblity checking of nodes. You can control the guidelines, and which guidelines are used per content type. You can also set accessibility checking on any text CCK field.

Accessible Content WYSIWYG
Sticks a link under every text field with an input filter that gives a preview of that textarea's accessiblity.

Accessible Content Service
Exposes the QUAIL module as a service via the Services module.

Accessible Content Themer
Lets users with the correct perms see a floating link to enable or disable a preview of all accessibility issues on the current page. Useful for checking the accessiblity of themes. You need to define a guideline first and then set it in admin/settings/accessibility_themer

Download

This is a D6 version only:
Accessible Content Module Download

Comments

That's Great!

mgifford's picture

Took a brief look at an initial install. I'm really looking forward to seeing quail available within a Drupal module.

I did want to know if you plan to bring this over to Drupal.org at some stage. I just trust the security work that goes on with code on the main site and it's also clear what the status of the license is too.

If you do move the quail libraries out of the main release of this drupal module, I like the process of sticking these external libraries in sites/all/libraries

I get this error, but going here admin/settings/accessibility_themer I don't have an option for anything to select in "Site-wide Guideline:":
# Site-wide guideline not set. Please set the site-wide guideline first.

Would be good to add the description of Accessibility Themer & Accessible Content in the admin/settings for clarity.

Upon the install it didn't "run 250 ac_test nodes", but wow! Sounds very comprehensive! Well, at least I didn't think it ran it, however the first node I created was #213, so there must have been a 212 created elsewhere. Adding the accessibility functionality to the blog node I wasn't able to get it to work. I could go to node/213/accessibility and didn't see the deliberate error I put in with a missing alt text. Although I'm not sure what I can define without first setting the guideline.

On editing the blog, I'm not sure what Check accessibility & Highlight accessibility Issues are supposed to do but they didn't work for me. Could be because I had disabled the AC, but I'd think that would be unrelated..

I found the enable/disable AC link in the bottom right but wasn't sure where to look for it. Good to add that to the docs.

Not sure where things went wrong, but let me know if I'm just missing something obvious. It's looking very helpful as a means of managing user input - the most difficult aspect of keeping a site accessible!

It looks like you did get all

kevee_gdo's picture

It looks like you did get all the test nodes installed, but you first need to go to node/add/ac-guideline and create a new guideline. In the guideline creation form, you'll see an 'Accessibility Tests' field area where you can check off all the tests you want to use. That should fix the issues you have outlined.

You'll need to then go back to the node type form for blog and select the guideline you just created.

I do really want to submit this to d.o; however, I wanted this community's feedback about whether this should be rolled into the Accessible module, or if it should be it's own module.

Starting to make more sense.

mgifford's picture

Thanks for this feedback. I scanned through the readme and this line didn't jump out at me:

You should probably first create a node of type ac_guideline and associate it with a few tests. In the future, we will probably need to provide a set of guidelines to begin with like WCAG 1 and 2, 508, etc.

Maybe it would be better phrased:

In order to evaluate the contributed content with this module you will need to ensure that there is at least one ac_guideline node type created and that it is selected for site wide compliance. You will have to look through and select which of the 250 tests you want to add. In the future, we will need to provide initial sets of guidelines (WCAG 1 and 2, 508, etc.) that will make it easier to select how your content is evaluated. Contributions of tests & required guidelines would be appreciated!

I did randomly select some tests, installed them and then ran into this error which is hitting all pages.

[29-Oct-2009 11:21:32] PHP Fatal error: Class 'scriptOnclickRequiresOnKeypress' not found in /Applications/MAMP/htdocs/drupal-6.9/sites/all/modules/accessible_content/quail/common/tests/scriptOnmouseoutHasOnmouseblur.php on line 3

Good to get community feedback, thanks. I think it would probably be best at this point to set it up as it's own module. I don't think John's had much time to update http://drupal.org/project/accessible recently. It's also different. The Accessible Helper Module is more about back-porting enhancements that we want to get into D7 back into D6. It will probably also be where we will put the accessibility enhancements that don't get into core.

johnbarclay's picture

Yeah. I haven't had much time for the accessible module. In an ideal world, the accessible module would both be for backports and api for accessibility preferences and function libraries.

I think the traditional Drupal development model is best for any accessibility modules:
1. Various modules are developed separately.
2. After their first iteration, common features, php functions, and configuration options are moved into an api and modules are modified to leverage the api.

The idea of coordinating a single "suite" of accessibility modules as one package seems problematic and my contrib priorities are LDAP integration and AEGIR modules currently.

I agree, the mission of the

kevee_gdo's picture

I agree, the mission of the two modules is very different, but I didn't want to be stepping on any toes.

I fixed the script tests, there's a class inheritance issue there and committed to the code.google.com site for QUAIL. This is the kind of thing that user testing is helpful for ;)

User testing is definitely helpful.

mgifford's picture

Make sure to send an updated link & add a version number to the tarball with the next release. I'd thought that you were going to put out a new bundled version but wasn't sure if version .3 were the latest or not. Would have helped if I'd checked the date.

$ svn checkout http://quail-lib.googlecode.com/svn/trunk/ quail-lib-read-only 
$ cd accessible_content
$ rm -fr quail
$ mv quail-lib-read-only/quail/ .
$ rm -fr quail-lib-read-only/

Ok. It's working now!

Have to run, but I'm impressed so far!

OK, I'm submitting the module

kevee's picture

OK, I'm submitting the module to d.o. Thanks for all the feedback, and now that I have the CSS sub-module of the Quail library done we'll be looking to a 0.1 release soon!

Thanks!

mgifford's picture

Good to hear and looking forward to checking out the next version!

Accessibility

Group notifications

This group offers an RSS feed. Or subscribe to these personalized, sitewide feeds: