Awesome
Matomo Icons
This repository provides the source files for the icons in Matomo and the scripts used to convert them into a unified format.
Contributing
An icon is missing, or you have a better one? Create a new issue or, even better, open a pull request.
🖌️ Hint: We regularly generate a list of improvable icons. Some may have the wrong source file format, some may be too small. Feel free to pick one or two and provide a PR for it.
All source files are stored in categorized subfolders in /src
.
Please check whether your icon proposal complies with the following conventions. Then run the convert.sh
script once to update the icon build in the /dist
folder.
File Formats
Ideally all source files should be SVGs or high resolution (> 100px) PNGs.
As this is not always possible, JPGs, GIFs and (even multi resolution) ICOs are supported as well.
Naming
The grouping and naming of all icons results from the data sets that Matomo uses in its own tracking analysis.
Icon category | Data source for naming | Example |
---|---|---|
brand | Device detection in Matomo Administration page | Apple.png |
browsers | https://github.com/matomo-org/device-detector/blob/master/Parser/Client/Browser.php | FF.png for Firefox Browser |
devices | https://github.com/matomo-org/matomo/blob/5.x-dev/plugins/DevicesDetection/functions.php#L183-L198 | smartphone.png |
flags | https://github.com/lipis/flag-icons/tree/main/flags/4x3 | at.png for Austria |
os | https://github.com/matomo-org/device-detector/blob/master/Parser/OperatingSystem.php#L38 | WIN.png for Windows |
plugins | https://github.com/matomo-org/matomo/tree/5.x-dev/plugins/DevicePlugins/Columns | flash.png |
searchEngines | https://github.com/matomo-org/searchengine-and-social-list/blob/master/SearchEngines.yml | google.com.png |
SEO | https://github.com/matomo-org/matomo/tree/5.x-dev/plugins/SEO | bing.com.png |
socials | https://github.com/matomo-org/searchengine-and-social-list/blob/master/Socials.yml | facebook.com.png |
Attribution
Every source file, except those in devices
, flags
, searchEngines
and socials
, needs to have a second file according to the scheme <icon name>.<file extension>.source
that mentions where the image is from.