|
Add automatically-awarded badges
|
|
|
_Note_: Pay close attention when following these steps. It is easy to create a badge, but much harder to edit it later. Double-check information is entered correctly in the YAML file on first go, or else you have to write SQL statements to fix it later.
|
|
|
Automatically awarded badges are created by the YAML rule file. Once the Ansible playbook finishes, the badge is created and placed in the https://badges.fedoraproject.org/explore/badges[badges index]. The only part _not_ created automatically are tags (see xref:badge-metadata[Badge metadata] below for info about tags). To add new tags, find the badge on https://badges.fedoraproject.org/[badges.fedoraproject.org]. If you are logged in as an admin, there is a text field to enter in new tags.
|
|
|
Add manually-awarded badges
|
|
|
_Note_: Pay close attention when following these steps. It is easy to create a badge, but much harder to edit it later. Double-check information is entered correctly on first go, or else you have to write SQL statements to fix it later.
|
|
|
Once the badge assets are pushed to the back-end, add the badge to the front-end, [.title-ref]#Tahrir#. The front-end is hosted at https://badges.fedoraproject.org/[badges.fedoraproject.org]. Follow these steps to add the badge in Tahrir.
|
|
|
Open _Admin_ interface on https://badges.fedoraproject.org/[badges.fedoraproject.org]
|
|
|
Go to the _Add badge_ section.
|
|
|
Enter in all information as provided in the badge ticket (see xref:badge-metadata[Badge metadata] below.)
|
|
|
Double-check all entered information is *correct and accurate*
|
|
|
Click _Create badge_ to create new badge
|
|
|
The badge is now created. You should be able to find in the https://badges.fedoraproject.org/explore/badges[badges index].
|
|
|
Grant authorizations
|
|
|
Manually-awarded badges require authorized users to issue a badge. You can do this at the bottom of the _Admin_ interface, near _Create Authorizations_. Add the person to receive awarding privileges into the _Person Email_ field. *This must be formatted as their fedoraproject.org email address* (e.g. FASuser [at] fedoraproject [dot] org). For badge name, use the slug (or badge name) from the URL of the badge (e.g. for https://badges.fedoraproject.org/badge/commops-superstar[badges.fedoraproject.org/badge/commops-superstar], this is `commops-superstar`).
|
|
|
To add multiple users, repeat this process for each user.
|
|
|
Badge metadata
|
|
|
*Name*: name of the badge – this determines URL of badge, so triple-check for typos
|
|
|
*Image*: full link to the PNG (e.g. `https://badges.fedoraproject.org/pngs/all-lowercase-dashes-only.png`)
|
|
|
*Description*: badge description text (ensure there is _no_ hanging whitespace)
|
|
|
*Criteria*: link to the issue in https://pagure.io/fedora-badges[fedora-badges]
|
|
