💖 What it does
By adding links across various wrangling pages, it reduces the number of clicks and pages you have to navigate. There are also buttons which let you quickly copy a tag's name or link.
Buttons can be added at the top of the wrangling pages, in the "Manage" column within bins, next to tag search results, and on tag comments in the AO3 Inbox. They can be icons or text.
The Tag Search results can be displayed in a table format, instead of the standard list.
🪴 How to use it
You can choose which buttons should be displayed, and where. After installing the script, open the configuration dialog to change the settings. Touching the code is not needed.
Not all buttons can be enabled in all places; overall, the following actions are available:
Search
: a link to the Tag Search page (/tags/search)
Search this Fandom
: a link to the Tag Search with this fandom already selected (this button will only display on Fandom tags)
New Tag
: a link to the New Tag page (/tags/new)
Landing Page
: a link to the Landing page (/tags/x) showing its tag associations
Edit
: a link to the Tag Edit page (/tags/x/edit)
Wrangle
: a link to the tag's Bin (/tags/x/wrangle)
Comments
: a link to the tag's Comments page (/tags/x/comments); at the top of pages also shows the number of comments on the tag
Works
: a link to the tag's Work listing (/tags/x/works); will show the number of total works (incl. subs and syns) on Edit pages of canonicals
Bookmarks
: a link to the tag's Bookmark listing (/tags/x/bookmarks); will show the number of total bookmarks (incl. subs and syns) on Edit pages of canonicals
Troubleshooting
: a link to the Troubleshooting page (/tags/x/troubleshooting) to fix common tag issues
Copy Name
: copy the tag's name (as plaintext) to the clipboard
Copy Link
: copy an HTML link to the tag, which can be pasted into an AO3 comment, to the clipboard
Copy Misc
: opens a little dialog with multiple formatting options to copy the tag to the clipboard; it adds a click but saves space if you need those other formats often
- the tag's name (plaintext)
- an HTML link for AO3 comments
- a link for pasting in Chat (useful if you're wrangling on mobile, see Known Limitations)
- a link for pasting in the wiki
Remove
: (only in bins) remove the tag from this fandom
Viewing the Tag Search results in a table can also be enabled in the configuration dialog.
If you prefer the table to only be as wide as the longest tag, you can enable the "Resize table dynamically with tags" option.
If Inbox & Comments are enabled in General Settings, it automatically turns plaintext URLs into clickable links. Then you can also turn the name of a tag into a link at the push of a button:
- In the comment, highlight the text which is the tag's name.
- Select the "Create Tag Link" button at the bottom right corner of the comment.
- The highlighted text turns into a link. Any action buttons enabled for Comments are shown to the right of the link.
🎨 How to configure it
In the main navigation of AO3, next to “About”, there’s a new menu item “Userscripts”.
From the “Userscripts” menu, select the “Wrangling Buttons Everywhere” option.
A configuration dialog opens. Here, you can set your preferences.
General Settings
The top section "General Settings" lets you choose where any of the buttons should be added:
Top of Page
enables buttons on any wrangling page, at the top right underneath the page heading
Bins
enables buttons in the "Manage" column in any bin
Inbox & Comments
enables buttons to be added next to any linked tag within a comment (both in the AO3 Inbox and on Comment pages)
Search
enables buttons to be added next to Tag Search results
Use icons instead of text labels
reduces the space each button needs by switching from textual labels to small icons.
Silently load Work/Bookmark/Comment counts
displays more info on buttons at the top of the page even where AO3 usually doesn't show it. On Works and Bookmarks pages, it pulls in the comment count. On Edit pages of canonical tags, it retrieves the total number of works and bookmarks (including all subs and syns). These silent page loads might get you rate-limited on work/bookmark/comment pages faster, and temporarily disabling this can help avoid it.
Top of Page, Bins, and Inbox & Comments
In each of these sections, their available action buttons are listed. Enable those you want to show up, or disable those you don't need.
Drag & drop the enabled buttons into the order you'd like to see them in.
Search
Action Buttons
In the "Search" section, the available action buttons are listed. Enable those you want to show up, or disable those you don't need.
Drag & drop the enabled buttons into the order you'd like to see them in.
Results Table
If you'd like the results of a Tag Search to be displayed as a table, enable Show Search Results as Table
. This will work even if you don't enable any action buttons for the Tag Search.
For the results table, you can additionally choose the order of the columns:
Type
: the tag type (Fandom, Character, Relationship, etc)
Name
: the name of the tag itself, which is always a link to the tag's Landing page
Uses
: the number of times this tag has been used by taggers
Manage
: the column holding any enabled action buttons
Peek Script
: If you're using the AO3: [Wrangling] Show fandoms in Tag Search! script or the AO3: [Wrangling] Fetch All Tag Info script, their data will always be added as columns at the right
If you'd like the table to always use the full width of the browser window, leave Resize table dynamically with tags
disabled. If the table should only be as wide as the longest tag name, enable the option.
🐞 Known limitations and cross-compatibility
This script is compatible with AO3: [Wrangling] Comment on tags without leaving bins!!!. Its "Add comment" button either follows the link to comment pages, or is kept at its original position. That depends on which action buttons you have configured and in which order the scripts run in your browser.
This script might not play well with others if they rely on the buttons in the "Manage" column. Ping me if you need help getting it to cooperate with another script. AO3: [Wrangling] Check Tag Status and AO3: [Wrangling] Check Unique Tag Users require a Works link as part of your configured buttons in the Bin.
Please note that the AO3: [Wrangling] Show fandoms in Tag Search! script has a separate configuration whether it should expect search results in a list or table format.
AO3: [Wrangling] Fetch All Tag Info requires the table view to be enabled.
Copying "for chat" will paste a formatted link on desktop, but not on the mobile app. The mobile app doesn't support pasting formatted links, so "for chat" instead pastes a combination of "[tag name] [tag link URL]".
The text and icon labels for the action buttons are fixed, but can be changed in the script's code. Ping me if you need help making those changes.
🏛️ History
- v4 - config setting to help avoid getting rate-limited
- v3 - new Copy Misc button with new options to copy links formatted for Chat and for Wiki
- v2 - add fandom-specific tag search link at top of Fandom tag pages
- v1
- migration from previously separate "All Action Buttons on all pages" and "All Action Buttons in Tag Bins" scripts
- incorporate logic to display Tag Search results as a table
- consistently add all navigation buttons on top of all wrangling pages and display number of comments, works, and bookmarks
- flexibly configure any navigation buttons within bins
- further compatability improvements to enable other scripts that add buttons