Custom search bookmarklets.

[mumblemutter]

UPDATE: As of Release 0.9.2, which introduced some changes to the search form, the syntax below won't work anymore. I'm working on updated versions and will post them here ASAP. /UPDATE

UPDATE REDUX: So, yeah, that didn't happen. I don't think I'll ever have time to really do this right, and there's plenty of other tips and tools you can use. Anyone else, feel free to play with the new search syntax and the bookmarklet if you wanna! /UPDATE REDUX



Long story short, these are bookmarklets you can use to search for a pre-specified subset of works for a fandom, character, pairing or random prompt. It makes use of the somewhat under-documented Advanced Search syntax (explained in more detail in this tutorial) and can be customized to accommodate even the most obscure reading preferences. /brazen claim

I've included the basic syntax (totally stolen from another bookmarklet) and several examples under the cut. Dreamwidth won't let me create draggable bookmarklets, so you will have to create and name the bookmark yourself, putting in the contents of the respective text field as the link location/URL. It's wildly important to delete any line breaks in the code before you do this; it needs to be one long unbroken string starting with javascript:s. A simple text editor, such as Notepad, works nicely for this.

Once bookmarked, you can click on it and it will either take a word you've highlighted on the page you're on, or ask for a prompt, and then plop that prompt into a pre-defined AO3 search. Prompts can be multiple words (such as character names), but they will be treated as one discrete search term. You cannot put in [Avengers Batmann] and expect crossover matches. Sorry.


Basic syntax:
javascript:s=''+(window.getSelection?window.getSelection():document.getSelection?document.getSelection():document.selection.createRange().text);if(!s)s=prompt('Prompt:','');void(open('http://archiveofourown.org/works/search?utf8=%E2%9C%93 &query[text]= &query[title]= &query[author]= &query[words]= &query[hits]= &query[kudos]= &query[date]= &query[language]= &query[tag]= +%22'+escape(s)+'%22'))
Line breaks included for readability. You can delete any parameter (&query[xxx]=) you don't need, but always keep the [tag] line at the end, as this is where your prompt is plopped in. You can mix and match search suggestions from the examples below, or else I'm happy to put something together for you!

Punctuation to be replaced like so:

%3E = >
%3C = <
%22 = "
%20 = [space]


Examples:

Poooorn!
Works rated Explicit or Mature that are between 750 and 5,000 words long and have accumulated more than 100 hits and more than 10 kudos

javascript:s=''+(window.getSelection?window.getSelection():document.getSelection?document.getSelection():document.selection.createRange().text);if(!s)s=prompt('Prompt:','');void(open('http://archiveofourown.org/works/search?utf8=%E2%9C%93&query[words]=750-5000&query[hits]=%3E100&query[kudos]=%3E10&query[tag]=explicit+OR+mature+%22'+escape(s)+'%22'))


Hold the porn.
Works rated General Audiences or Teen that were bookmarked as a "rec" by at least one user.

javascript:s=''+(window.getSelection?window.getSelection():document.getSelection?document.getSelection():document.selection.createRange().text);if(!s)s=prompt('Prompt:','');void(open('http://archiveofourown.org/works/search?utf8=%E2%9C%93&query[recced]=true&query[tag]=%22general%20audiences%22+OR+teen+%22'+escape(s)+'%22'))


Give me consent or give me... more consent!
Works that do not contain "dubious consent", "non-con" or related words in either the tags, summary, or notes, and are not tagged "Author Chose Not To Use Archive Warnings"

javascript:s=''+(window.getSelection?window.getSelection():document.getSelection?document.getSelection():document.selection.createRange().text);if(!s)s=prompt('Prompt:','');void(open('http://archiveofourown.org/works/search?utf8=%E2%9C%93&query[text]=-rape+-"non-con"+-"dub-con"+-"dubious%20consent"+-dubcon+-"consent%20issues"&query[tag]=-%22not%20to%20use%20archive%20warnings%22+%22'+escape(s)+'%22'))


It's not just the size that matters, it's also the follow-through.
Works that are over 20,000 words long and completed.

javascript:s=''+(window.getSelection?window.getSelection():document.getSelection?document.getSelection():document.selection.createRange().text);if(!s)s=prompt('Prompt:','');void(open('http://archiveofourown.org/works/search?utf8=%E2%9C%93&query[words]=%3E20000&query[complete]=true&query[tag]=%22'+escape(s)+'%22'))


Just the vanilla, please.
Works that do not contain the following tags: Kink, Gunplay, Painplay, Watersports, BDSM, D/s, Dom/Sub, Adultery, Incest, Underage, Dubious Consent, Rape, Consent Issues, Blood, Dark Themes, Graphic Depictions of Violence, Death.

javascript:s=''+(window.getSelection?window.getSelection():document.getSelection?document.getSelection():document.selection.createRange().text);if(!s)s=prompt('Prompt:','');void(open('http://archiveofourown.org/works/search?utf8=%E2%9C%93&query[tag]=-kink+-gunplay+-painplay+-watersports+-BDSM+-%22D/s%22+-%22dom/sub%22+-adultery+-incest+-underage+-%22dubious%20consent%22+-rape+-%22consent%20issues%22+-blood+-%22dark%20themes%22+-%22graphic%20depictions%20of%20violence%22+-death+%22'+escape(s)+'%22'))


None of the warnings, all of the fun.
Works rated Explicit or Mature that are not tagged for Graphic Violence, Underage, Non-Con or Major Character Death.

javascript:s=''+(window.getSelection?window.getSelection():document.getSelection?document.getSelection():document.selection.createRange().text);if(!s)s=prompt('Prompt:','');void(open('http://archiveofourown.org/works/search?utf8=%E2%9C%93&query[tag]=explicit+OR+mature+%22no%20archive%20warnings%20apply%22+-%22not%20to%20use%20archive%20warnings%22+%22'+escape(s)+'%22'))


I read fic for the plot.
Works that are over 10,000 words long, tagged Adventure OR Action OR Case Fic OR Plotty and rated anything below Explicit.

javascript:s=''+(window.getSelection?window.getSelection():document.getSelection?document.getSelection():document.selection.createRange().text);if(!s)s=prompt('Prompt:','');void(open('http://archiveofourown.org/works/search?utf8=%E2%9C%93&query[words]=%3E10000&query[tag]=-explicit+adventure+OR+action+OR+%22case%20fic%22+OR+plotty+%22'+escape(s)+'%22'))


Romance, what romance.
Works rated for General Audiences, excluding those tagged Romance, Sex, Fluff, Slash, Het or Femslash.

javascript:s=''+(window.getSelection?window.getSelection():document.getSelection?document.getSelection():document.selection.createRange().text);if(!s)s=prompt('Prompt:','');void(open('http://archiveofourown.org/works/search?utf8=%E2%9C%93&query[kudos]=%3E5&query[tag]=%22general%20audiences%22+-romance+-sex+-fluff+-slash+-het+-femslash+%22'+escape(s)+'%22'))


Pretty pictures!
Works tagged as Fanart.

javascript:s=''+(window.getSelection?window.getSelection():document.getSelection?document.getSelection():document.selection.createRange().text);if(!s)s=prompt('Prompt:','');void(open('http://archiveofourown.org/works/search?utf8=%E2%9C%93&query[tag]=fanart+%22'+escape(s)+'%22'))


Feel free to shout if anything seems off to you, or if anything is unclear. I could have rambled on more, but I tried to keep the explanations short. Short-ish.