Hi everyone,

I develop a Wordpress plugin for a German public authority which allows to configure and download pictograms similar to your site. Therefore I had some fun with the API and thought I share my findings with you to improve this great project even further. If this is not the appropriate place, please move the issue or give me a hint. The following list is work in progress and not ordered or something. Just a few findings, or thoughts.

• for easier API changes, a version would be great (e.g. /api/v1/)
• in general the API documentation should include descriptions of every response field
• /pictograms/{locale}/{idPictogram} is responding with non-translated keywords. If I use /pictograms/{idPictogram}/languages/{languages} I can see that there are translated keywords.
• there is no documentation how I can use the endpoint /pictograms/{idPictogram}/languages/{languages} for multiple languages. I have to try it with the example.
• /pictograms/{idPictogram} only allows to get a resolution of 500px or 2500px. With https://static.arasaac.org/pictograms/2340/2340_300.png I can also get images with 300px which is great for search results.
• /pictograms/all/{locale} is a crazy endpoint, because it just takes too long and it's too much data. Some pagination would be great.
• /pictograms/{locale}/search/{searchText} and /pictograms/{locale}/new/{numItems} (in general all search like endpoins) should have the same response structure. This would make development easier.
• Maybe I don't know enough about the field, but what is the purpose of the schematic, sex, and violence field?
• Is there any way to get the audio from arasaac.org? Would be great if this could be included in the API.
• It would also be great if there would be a license or copyright/author field in the response, because this would ensure that we are always showing the correct license. Even if currently all pictograms are licensed the same, this could maybe change in the future.
• All pictograms are looking like they are vector graphics, therefore it would be nice if svg's or something else could be exposed.

I hope that's not too much at once 😉

In case you are interested, what the WP plugin looks like (I will open another issue if the plugin is released):

I changed the organisation of the configuration options, since I believe related options should be grouped. With the great API it was also possible to hide all parameters which are not available.

Hey,
👋 hello @juanda99 from belgium,
we know arasaac and araword for a few years now, because it runs on linux and is open source.
My Gf is a speach terapist and use your tools on a daily basis...
we discovered the new website 👍 good job...
and thanks

Wanted to let you know that make it available in french is really appreciated here and make it open too!
How can we help you build this (technically or not)?
do not hesitate to leave a few things in the issues i might pick something if i have some time available.

really nice project ❤️

I get an error on firefox:
Uncaught ReferenceError: ClipboardItem is not defined

Seem to be related to this bug (still not implemented):
https://bugzilla.mozilla.org/show_bug.cgi?id=1619251

Alpha channel not working on Windows, get a black background color. Working ok in Mac & Linux

Issue Type

• [*] Bug

Description

Footer does not stick to bottom.

Steps to reproduce

N/A

Versions

• Browser: IE11