Tips and tricks =============== This page contains some tips and tricks on how to use pagure. These do not fit in their own page but are worth mentioning. Place image onto your overview page ----------------------------------- You can only use images that come from the Pagure host itself. Example ~~~~~~~ :: ![See Copr workflow](/copr/copr/raw/master/f/doc/img/copr-workflow.png) Text in the square brackets will be used as an alt description. Pre-fill issue using the URL ---------------------------- When creating issues for a project pagure supports pre-filling the title and description input text using URL parameters. Example: ~~~~~~~~ https://pagure.io/pagure/new_issue/?title=<Issue>&content=<Issue Content> The above URL will autofill the text boxes for Title and Description field with Title set to <Issue> and Description set to <Issue Content>. Pre-fill issue template using the URL ------------------------------------- When creating issues for a project pagure supports pre-filling the title and description input text using URL parameters. Example: ~~~~~~~~ https://pagure.io/pagure/new_issue/?template=<TemplateName> The above URL will autofill the ticket with the specified template. The TemplateName should be the name of the template file on disk (in the ``templates`` directory of the ticket git repository). Filter for issues *not* having a certain tag -------------------------------------------- Very much in the same way pagure allows you to filter for issues having a certain tag, pagure allows one to filter for issues *not* having a certain tag. To do this, simply prepend a ``!`` in front of the tag. Example: ~~~~~~~~ https://pagure.io/pagure/issues?tags=!easyfix Local user creation without email verification ---------------------------------------------- If you set ``EMAIL_SEND`` to ```False``` from the configuration file, you will get the emails printed to the console instead of being sent. The admin of the instance can then access the URL to manually validate the account from there. This is generally used for development where we don't need to send any emails. Filter an user's projects by their access ----------------------------------------- When watching a user's page, the list of all the project that user is involved in is presented regardless of whether the user has ticket, commit, admin access or is the main admin of the project. You can specify an ``acl=`` argument to the URL to filter the list of projects by access. .. note:: This also works for your home page when you are logged in. Examples: ~~~~~~~~~ https://pagure.io/user/pingou?acl=main admin https://pagure.io/user/pingou?acl=admin https://pagure.io/user/pingou?acl=commit Filter issues by (custom) fields -------------------------------- Via the project's settings page, admins can set custom keys to be used in issues. You can search them using the URL via the arguments ``ckeys`` and ``cvalue`` or simpler, using the search field at the top of the issue page. This also works for the following regular fields: ``tags``, ``milestones``, ``author``, ``assignee``, ``status``, ``priority`` (but tags and milestones despite their name only support a single value). Examples: ~~~~~~~~~ https://pagure.io/SSSD/sssd/issues?status=Open&search_pattern=review%3ATrue https://pagure.io/pagure/issues?status=Open&search_pattern=tags%3Aeasyfix Search the comments of issues ----------------------------- One can search all the comments made on an issue tracker using ``content:<keyword>`` in the search field. This is going to search all the comments (including the descriptions) of all the tickets and thus can be quite slow on large project. This is why this feature isn't being pushed much forward. Examples: ~~~~~~~~~ https://pagure.io/pagure/issues?status=Open&search_pattern=content%3Aeasyfix