matomo-mirror/matomo-icons
1
0
Fork 0
mirror of https://github.com/matomo-org/matomo-icons.git synced 2024-09-07 03:03:45 +02:00
Code Releases Activity
Source files for the icons in Matomo
393 commits 1 branch 0 tags 30 MiB
Python 72%
Shell 26.4%
PHP 1.6%
Find a file
Lukas Winkler 611a44884c
convert new cookie icon from #33
2024-07-21 01:11:32 +02:00
.github Overwrite global PR template 2021-06-17 10:01:36 +12:00
dist convert new cookie icon from #33 2024-07-21 01:11:32 +02:00
src Merge pull request #33 from pixelbrackets/20240604-replace-cookie-icon 2024-07-21 01:06:06 +02:00
tools update conversion of all icons 2024-07-21 00:50:40 +02:00
.gitattributes visual div 2017-02-18 11:46:12 +01:00
.gitignore replace git submodules with npm packagereplace git submodules with npm 2019-03-22 19:54:59 +01:00
.gitmodules update flags 2017-04-19 09:59:20 +02:00
.travis.yml use 20.04 for travis 2022-02-19 21:17:04 +01:00
analyseIco.py use python3 for ico detection 2019-10-03 20:23:01 +02:00
composer.json use device detector 4 2020-11-01 09:55:00 +01:00
convert.sh update flags 2024-07-21 01:04:04 +02:00
devicedetector.php use device detector 4 2020-11-01 09:55:00 +01:00
gpl-3.0.txt add license 2017-02-22 10:44:15 +01:00
package-lock.json update flags 2024-07-21 01:04:04 +02:00
package.json update all dependencies 2023-07-22 21:51:50 +02:00
README.md feat: Enhance contribution guide 2024-06-04 14:34:41 +02:00
referrers.py fix paths 2017-11-16 22:28:24 +01:00
requirements.txt update all dependencies 2023-07-22 21:51:50 +02:00
sort.py add more brands and sort list 2019-07-03 11:49:22 +02:00
tests-ignore.yml add a lot of browser icons 2020-08-07 17:14:58 +02:00
tests.py disable build script test 2023-07-22 21:58:38 +02:00
unk.flag.svg simpler unknown flag and placeholder for missing flags 2017-02-21 14:33:30 +01:00
versions.txt update conversion of all icons 2024-07-21 00:50:40 +02:00

README.md

Matomo Icons

Build Status

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.