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=""></issue></issue>

The above URL will autofill the text boxes for Title and Description field

with Title set to <issue> and Description set to <issue content="">.</issue></issue>

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></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</keyword>

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