BVA Forum Index
phpBB Web and Accessibility Standards Overhaul (phpBB WASO) Version 2.0.04
The overall goal of these mod and style changes are to improve the existing phpBB by;
- Attempting to meet the W3C Web Content Accessibility Guidelines - Level A
- Striving to validate all forum pages as XHTML 1.0 Strict
- Separating structure/semantics from presentation using CSS for layout
Acknowledgements
First off, it's important to thank those who have assisted. Here's some of the people who helped to make this possible;
- My wife and son for being patient.
- The Accessify Forums for leading me to the road to enlightenment.
- Tommy Olsson for helping out in the very beginning with Accessibility standards, PHP, and honest feedback.
- Joe Clark for your book on Building Accessible Websites and your unique writing style that constantly keeps my nose in the dictionary.
- rebelia e horus dalle tribune di Olimpo Informatico.
Accessibility Statement
Access Keys
There are the following accesskeys in use for this forum;
- Access key of 0 will allow you to skip to the content on each applicable page.
- Access key of 1 will take you back to the forum's index page.
- Access key of 2 will take you to the forum's Search page.
- Access key of 3 will take you to the forum's About page.
- Access key of 4 will take you to the forum's Register page to create a forum account.
- Access key of 5 will log you in to the forum.
- Access key of 6 will log you in to check your private messages.
For the Windows platform, you can use the 'alt' key with the accesskey of your choice. For the Macintosh, you can use the 'control' key with the accesskey of your choice.
Standards
- All documents strive to validate as XHTML 1.0 Strict. (Note: Some documents rely in some heavy use of Javascript and the call to the form attribute of 'name'. With XHTML 1.0 Strict, this attribute will make the document not valid. However, for the interest of keeping the existing functionality, this attribute will remain until more work can be done to improve the Javascript. As well, there are issues with messages being posted by users that can cause erroneous placement of tags which will also cause a document to be not valid. Again, this is being looked at for improving for Standards compliance.)
- All documents strive to meet the requirements of the W3C Web Content Accessibility Guidelines - Level A
- All documents strive to meet the requirements of Section 508
- All CSS files have been validated using the W3C CSS validation tool.
Semantics
Every document is built with the same semantic structure in mind;
- Heading 1 is for the main title of the forum.
- Heading 2 is for the forum slogan.
- Heading 3 is for the top navigation to each forum and topic as well as the forum footer.
- Heading 4 is for the main title for each content area.
- Heading 5 is for each subtitle in each content area.
- Definition list for the list of forum categories and topics.
- Unordered lists for associated items.
Screen Readers
There were three screen readers used for testing of the phpBB WASO;
- JAWS 7.0 for Windows
- Windows Eyes 5.0 for Windows
- HAL 6.50 for Windows
Here's a summary of the changes that resulted from this testing;
- Making the text that indicated to the user the status of a particular forum and topic, such as 'New Posts' or 'Announcements' understandable when read out in context to the forum and topic name.
- Adding acronyms elements to certain text.
- Changing the date format from a short month name to a long month name. Such as 'October' instead of 'Oct'.
- Adding title attributes to lists that are meant for visual legends. Such as the small and large icon legends.
- Changes to the language files for better screen reader results
Minimum Requirements
Here is a list of what you will need to use phpBB WASO;
- A host that provides PHP support
- phpBB (2.0.21 release is mandatory)
- MySQL, MS-SQL, PostgreSQL or Access/ODB
- A very good understanding of XHTML with CSS for design
Browsers and Operating Systems
For a great experience, I recommend at least;
- Internet Explorer 5.x for Windows
- Mozilla 1.6 for Windows
- Firefox 1.x for Windows
- Safari 1.2 for Macintosh
- Opera 7.5x for Windows
- Netscape 7.x for Windows, Macintosh and Linux
- AOL 9.0 for Windows
For an average, but still functional experience, you could use;
- Konquerer 3.x for Linux
And I wouldn't recommend;
- IE 5.x for Macintosh
- Netscape 4.x and 6.x for Windows, Macintosh and Linux
Installation Notes:
REMEMBER TO BACK UP YOUR FILES BEFORE APPLYING THIS MOD AS MANY FILES WILL BE OVERWRITTEN!!!
Installation using EasyMOD v0.3.0
To install;
- Unzip the file 'phpbb-waso-2004-mod.zip' into your '/admin/mods/' directory
- Log in with your administration name and password to access your Administration panel
- In the admin panel, navigate to 'MOD center', then 'Install MODs'
- Enter your EasyMOD Password, then 'Access EasyMOD'
- You should see in your list of 'Unprocessed MODs', you should see a listing for 'phpBB WASO'. Inline with this listing, select 'Process'
- You will see 'Step 1 of 3 - Processing completed successfully!'. If so, then select 'Next Step'
- You will then see 'Step 2 of 3 - Proposed Database Alterations'. For this MOD, this is not applicable. Therefore, select 'Complete Installation'
- You will then see 'Step 3 of 3 - Installation Complete!'. Feel free to see the list of changes to the applicable files
- In the admin panel, navigate to 'Style Admin', then 'Add'
- You should see 'crazybat' as one of the themes available. If so, select 'install'. If successful, you should see 'The selected theme has been installed successfully'
- Navigate to 'General Admin', then 'Configuration'
- Next to 'Default Style', choose 'crazybat' as the style
- Next to 'Override user style - Replaces users style with the default', choose 'Yes'
- Hit 'Submit'
- Navigate to 'Administration' and go to 'Forum Index'. Your phpBB WASO MOD should now be visible
Manual preMOD Installation
To install;
- Unzip the file 'phpbb-waso-2004-premod.zip' into your forum directory. (ie: http://yoursite.com/forums/)
- You will be warned that files of the same name will be overwritten. Select 'Yes' to overwrite the necessary files
- Navigate to your forums with your browser of choice
- Log in with your administration name and password to access your Administration panel
- In the admin panel, navigate to 'Style Admin', then 'Add'
- You should see 'crazybat' as one of the themes available. If so, select 'install'. If successful, you should see 'The selected theme has been installed successfully'
- Navigate to 'General Admin', then 'Configuration'
- Next to 'Default Style', choose 'crazybat' as the style
- Next to 'Override user style - Replaces users style with the default', choose 'Yes'
- Hit 'Submit'
- Navigate to 'Administration' and go to 'Forum Index'. Your phpBB WASO MOD should now be visible
Again, please take the appropriate caution when using these files. I have taken great care to assure quality assurance, but please remember to back up your files before installing this MOD.
Revision History
Note: As this page was getting too big, I have moved the release notes to a text file.
Known Issues
Browser issues
Internet Explorer 5.x and above
- Images flicker when you mouseover the toolbar items.
- Minor inconsistencies with margin and padding values.
Opera 7.x and above
- Base font size in the Style Sheet is set to 90%. Opera renders the text out at 90% of the size that IE and Firefox/Mozilla do.
Forum issues
- Certain pages might fail validation. The markup inserted, when using BB code, can leave unclosed elements. Usually with the message body of the posts and private messages.
Individual template issues
about_body.tpl
- Template is currently in English only. If anyone would like to volunteer to translate the page, I'd welcome any assistance.
posting_body.tpl
- Template doesn't validate as the form element is using the name attribute 'post'. This would be due to the extensive Javascript that is powering this page and the use of 'document.post.xxx'. If there are any Javascript experts out there, I'd welcome any suggestions with making this page work with the form id attribute 'post' and the use of 'document.getElementById('post').xxx'.
posting_topic_review.tpl
- 'postrow.U_POST_ID' doesn't generate any value, which will cause this page to not validate as there can be multiple instances of the same id attribute. This exists on the existing phpBB 2.0.17.