-
Notifications
You must be signed in to change notification settings - Fork 6
2.8 Advanced Features
Mostly, people want to create links to recently created items in Git. In this case, it should be easy to find the item near the top of the list (they are sorted by date). If you don't see the item that you are looking for or don't want to scroll through the whole list to find it, you should try the filter option.
Filtering enables you to find the item that you are looking for much faster. You can filter issues, pull/merge requests, and commits. Filtering searches through multiple attributes on the item and highlights any locations where the text was found. When the filter box is empty it shows what attributes can be used for filtering the results.
In most cases, this is the fastest way to find the item that you are looking for. There are, however, some cases when this method won't be sufficient. This is due to a limitation that exists for performance reasons. In order to provide the best combination of usability and performance, the plugin only loads approximately the last 100 items.
To be more specific, the plugin loads:
- the last 100 commits from the default branch (usually master)
- the last 100 issues, both open and closed (less than 100 when connected with GitHub)
- the last 100 pull/merge requests, both open and closed (less than 100 when connected with GitHub)
The filter box only searches through the loaded items. If you need to link to an older item that is not contained in the list you can still find it using the search box.
The search box takes an id (or sha for commits) and looks for such an item in Git. This means that you need to first know the id of the item that you want to link. The id is easy to find when viewing the item in GitHub/GitLab.
Type or paste the id into the search box and click the Search
button. If the item was found, you should see a single result. Click the blue link icon to add it to the list of items to be linked. To get back to the list of recent items, click the Clear
button.
This method can also be used to create a link to a commit that is not in the default branch. Simply search for the sha hash of the commit and create a link like normal.