Accessibility Improvements
Quote from paulfilkin on April 8, 2024, 12:13 pmHi,
I have set up a very basic forum to use for a project I’m running that will involve blind users testing and providing feedback on some software we develop. I cannot use the forums we use within our company (Verint Community) because it’s not accessible, but I’m very happy to be able to say that using Asgaros as we tested thoroughly this morning made it possible for a blind user coming to this forum for the first time to be able to get logged in and also create topics and posts. So very happy about that!
However, there are some small things I would like to improve and I’m looking for some advice on how I can do this.
- It would be useful if we could copy/paste an image into a post instead of having to save the image to your computer somewhere and then load it as a file.
- When adding an image inline there is no mechanism for selecting an image at all. In fact I’m not sure this is useful at all since the field “Source” in non-descriptive in terms of what you are supposed to do there?
- There is no mechanism for adding alt-text for a screen reader so if we wanted to use this we cannot. Although given we can’t seem to add images inline this is less of a problem as we will always describe things anyway since images are not a lot of use for blind users. But if we ever used this forum for sighted users this would be a problem.
- When I add a new user in the UserGroup they receive an email with two links. One for them to change their password and one to login. Both links are provided in the notification email they receive. How can I customise this email so that I don’t give them the login link, but rather only the one where they can set their password?
- Once a user clicks on the change password link there is no obvious way to get out of that screen and go to the forums. As a sighted user I know I could do this a number of ways, but after watching a blind user this morning this was not possible at all for her to find a way to get to the forums without thinking that perhaps she could edit the url in the browser. So is there a way I can customise the account page and add a link to go to the forums?
- Last thing… there is a small letter(s) below the post editor that seems to be some sort of navigator based on the document structure. So P for paragraph, LI for list item etc. This is actually unlabeled and everyone testing it asked what it was for. I’m not sure what purpose it serves, so can I remove this?
That’s it… everything else we can live with as it is pretty good compared to many I looked at.
Hi,
I have set up a very basic forum to use for a project I’m running that will involve blind users testing and providing feedback on some software we develop. I cannot use the forums we use within our company (Verint Community) because it’s not accessible, but I’m very happy to be able to say that using Asgaros as we tested thoroughly this morning made it possible for a blind user coming to this forum for the first time to be able to get logged in and also create topics and posts. So very happy about that!
However, there are some small things I would like to improve and I’m looking for some advice on how I can do this.
- It would be useful if we could copy/paste an image into a post instead of having to save the image to your computer somewhere and then load it as a file.
- When adding an image inline there is no mechanism for selecting an image at all. In fact I’m not sure this is useful at all since the field “Source” in non-descriptive in terms of what you are supposed to do there?
- There is no mechanism for adding alt-text for a screen reader so if we wanted to use this we cannot. Although given we can’t seem to add images inline this is less of a problem as we will always describe things anyway since images are not a lot of use for blind users. But if we ever used this forum for sighted users this would be a problem.
- When I add a new user in the UserGroup they receive an email with two links. One for them to change their password and one to login. Both links are provided in the notification email they receive. How can I customise this email so that I don’t give them the login link, but rather only the one where they can set their password?
- Once a user clicks on the change password link there is no obvious way to get out of that screen and go to the forums. As a sighted user I know I could do this a number of ways, but after watching a blind user this morning this was not possible at all for her to find a way to get to the forums without thinking that perhaps she could edit the url in the browser. So is there a way I can customise the account page and add a link to go to the forums?
- Last thing… there is a small letter(s) below the post editor that seems to be some sort of navigator based on the document structure. So P for paragraph, LI for list item etc. This is actually unlabeled and everyone testing it asked what it was for. I’m not sure what purpose it serves, so can I remove this?
That’s it… everything else we can live with as it is pretty good compared to many I looked at.
Quote from Jim on April 11, 2024, 3:54 am@paulfilkin I’m not connected with this software, except as a user like you. You have many complex questions. I’ll just address #4, the new user email.
When you add a new user to a User Group, you are taken to the Wordpress admin, Add New User page. You are not in Asgaros Forum admin anymore, and I think the email that is generated when you create the new user does not come from Asgaros; it comes directly from your Wordpress installation. So what you want is more of a Wordpress issue than an Asgaros issue.
You can edit the contents of the email that new users receive. It is a bit complicated. I will show you how I edited mine, and maybe that will be enough for you to take it from there. If you delete one of the links and associated text, obviously it will not appear in the email. If you’ve never worked with php and filters, this will be meaningless.
/* Subject and content of new user email for email confirmation.
This hooks into a filter applied in wp-includes/pluggable.php
Had to get clever to extract the key in the set password URL!
For some reason, adding ‘<’ and ‘>’ around the url now makes that line disappear!
*/
function fp_wp_new_user_notification_email( $array, $user, $blogname ) {
parse_str( $array[‘message’], $urlvars ); // this extracts variables from URL, including $key
$key = $urlvars[‘key’]; // used to compose URL
$first_name = get_user_meta( $user->ID, ‘first_name’, true );
$message = sprintf( ‘%s (username %s):’, $first_name, $user->user_login ) . “\r\n”;
$message .= ‘Thank you for registering and welcome to forestpathology.org!’ . “\r\n\r\n”;
$message .= ‘To set your password, please visit the following address:’ . “\r\n”;
$message .= ‘<’ . network_site_url(“wp-login.php?action=rp&key=$key&login=” . rawurlencode($user->user_login), ‘login’) . “>\r\n\r\n”;
$message .= ‘Thereafter, to log in, you can click the login link in the sidebar or bookmark this:’ . “\r\n”;
$message .= wp_login_url() . “\r\n\r\n”;
$message .= ‘The password link will expire 24 hours from the time it was sent.’ . “\r\n”;$array[‘subject’] = ‘Your registration on forestpathology.org’;
$array[‘message’] = $message;
return $array;
}
add_filter( ‘wp_new_user_notification_email’, ‘fp_wp_new_user_notification_email’, 10, 3 );
@paulfilkin I’m not connected with this software, except as a user like you. You have many complex questions. I’ll just address #4, the new user email.
When you add a new user to a User Group, you are taken to the Wordpress admin, Add New User page. You are not in Asgaros Forum admin anymore, and I think the email that is generated when you create the new user does not come from Asgaros; it comes directly from your Wordpress installation. So what you want is more of a Wordpress issue than an Asgaros issue.
You can edit the contents of the email that new users receive. It is a bit complicated. I will show you how I edited mine, and maybe that will be enough for you to take it from there. If you delete one of the links and associated text, obviously it will not appear in the email. If you’ve never worked with php and filters, this will be meaningless.
/* Subject and content of new user email for email confirmation.
This hooks into a filter applied in wp-includes/pluggable.php
Had to get clever to extract the key in the set password URL!
For some reason, adding ‘<’ and ‘>’ around the url now makes that line disappear!
*/
function fp_wp_new_user_notification_email( $array, $user, $blogname ) {
parse_str( $array[‘message’], $urlvars ); // this extracts variables from URL, including $key
$key = $urlvars[‘key’]; // used to compose URL
$first_name = get_user_meta( $user->ID, ‘first_name’, true );
$message = sprintf( ‘%s (username %s):’, $first_name, $user->user_login ) . “\r\n”;
$message .= ‘Thank you for registering and welcome to forestpathology.org!’ . “\r\n\r\n”;
$message .= ‘To set your password, please visit the following address:’ . “\r\n”;
$message .= ‘<’ . network_site_url(“wp-login.php?action=rp&key=$key&login=” . rawurlencode($user->user_login), ‘login’) . “>\r\n\r\n”;
$message .= ‘Thereafter, to log in, you can click the login link in the sidebar or bookmark this:’ . “\r\n”;
$message .= wp_login_url() . “\r\n\r\n”;
$message .= ‘The password link will expire 24 hours from the time it was sent.’ . “\r\n”;
$array[‘subject’] = ‘Your registration on forestpathology.org’;
$array[‘message’] = $message;
return $array;
}
add_filter( ‘wp_new_user_notification_email’, ‘fp_wp_new_user_notification_email’, 10, 3 );
Quote from paulfilkin on April 11, 2024, 6:05 pmThanks @jim, I really appreciate you taking the time to reply.
Great solution… but in the end I solved this using the UsersWP plugin (https://userswp.io/) which gives me exactly the kind of control I needed over this with an easy way to customise the emails and the various pages for login, redirect, change password etc. I didn’t realise there were so many until I used this!
It also let me solve #5 as well as I could create some custom text at the top of the account settings page to redirect the user directly to the forums if they chose.
#1, #2, #3 and #6 are still problems. I’m not sure I’ll get any help for these, but at least now I can more comfortably use this platform for this project. It’s not perfect for accessibility by any means as it loses focus and doesn’t react to the keyboard navigation most screen reader users expect, but we can make it work. So a few simple instructions and we’re good to go!! A lot better than Verint Community when it comes to accessibility and that is not cheap!!
Thanks @jim, I really appreciate you taking the time to reply.
Great solution… but in the end I solved this using the UsersWP plugin (https://userswp.io/) which gives me exactly the kind of control I needed over this with an easy way to customise the emails and the various pages for login, redirect, change password etc. I didn’t realise there were so many until I used this!
It also let me solve #5 as well as I could create some custom text at the top of the account settings page to redirect the user directly to the forums if they chose.
#1, #2, #3 and #6 are still problems. I’m not sure I’ll get any help for these, but at least now I can more comfortably use this platform for this project. It’s not perfect for accessibility by any means as it loses focus and doesn’t react to the keyboard navigation most screen reader users expect, but we can make it work. So a few simple instructions and we’re good to go!! A lot better than Verint Community when it comes to accessibility and that is not cheap!!