SEARCH GUIDE

this list contains a comprehensive guide on how to work with the tags and filters.

most, if not all, of the "specific" parameters are basically carbon copies of the in-built filter functions of pocketbase, so if you're familiar with that, you'll be able to pick up this stuff pretty quickly.

TAGS

---

searches are done primarily using tags in most cases, however, there are several different search fields, each of which behave slightly differently, but with a few shared characteristics.

two tags, seperated by a space. will return posts that are tagged both "raccoon" and "fox".

two words that are part of the same tag are seperated by an underscore.

two tags inside of a set of (parenthesis), seperated by a space. all results inside of () must all be true. conversely, if you put your values inside of -(), all results must be false.

returns every post tagged "frog", regardless of any other searches.

return posts that don't have the "anaconda" tag.

so, to put all of that into a compiled form:

this would return all posts tagged "evie_almond" and "butt", while also returning all posts that have "frog" tagged. any post that comes from this group that has the "anaconda" tag is automatically retracted from the final results. the first query set is treated as priority, followed by the second, the third, and so on.

KEYWORDS

---

certain keywords have been reserved to help aid in searching. in the "fancy" search, they are accessed simply in the advanced option under the menu, however all options are operational from the search itself.

• order | sort :: order by field. adding a - will reverse the ordering. all valid fields are listed further below.
• page :: current page of results.
• perpage :: amount of results to display per page. in most cases, the hard limit is 50 results per page, with 25 as the default value. by default, this will use the value inside of the settings menu, and will not be useable in the text search.
• before :: returns any results created before a given date. format is YYYY-MM-DD, YYYY, YY, MM-DD, YYYY-MM.
• after :: returns any results created after a given date. format is YYYY-MM-DD, YYYY, YY, MM-DD, YYYY-MM.
• desc:: searches the description and title of results. only works for searches in the archive.
• tagged :: searches for tagged results by tag name (as opposed to ID). will not work when searching comments.

FILTERS

---

filters are applied as additional rules to follow when searching for tags, and are applied as absolutes -- this means that every filter value must be met in order for results to appear. i may add the ability in the future to make certain filters optional, but i do not have the intention to do so at this time.

most of the following has been copied directly from the pocketbase documentation on list searching.

the syntax basically follows the format FIELD OPERATOR VALUE, where:

FIELD :: the field to conduct your query. valid fields are listed further below.

OPERATOR :: the operation to perform on your query. these include:

• = | : Equal
• != NOT equal
• > greater than
• >= greater than or equal
• < less than
• <= less than or equal
• ~ like/contains (right OPERAND becomes wildcard if not specified)
• !~ NOT like/contains (right OPERAND becomes wildcard if not specified)
• ?= any/at least one of Equal
• ?!= any/at least one of NOT equal
• ?> any/at least one of greater than
• ?>= any/at least one of greater than or equal
• ?< any/at least one of less than
• ?<= any/at least one of less than or equal
• ?~ any/at least one of like/contains (right OPERAND becomes wildcard if not specified)
• ?!~ any/at least one of NOT like/contains (right OPERAND becomes wildcard if not specified)

VALUE :: text, numbers, true/false, null. can be contained inside of 'quotes', "double quotes", `and whatever the fuck these are called`, which will all be treated as a single string.

EXAMPLES:

returns all posts that contain source files.

returns any posts that contains the phrase "tails has such a fat, fuckable asshole" in the description or title.

returns all posts that have more than 2 files connected to it.

FIELDS

---

the following are valid fields, and which searches they are valid for.

field	description	valid searches
id	ID value of the record.	all
created	date of creation	all
updated	date of last edit	all
title	title value of the record.	posts, projects, queue
description	description value of the record.	posts, projects
ask	related ask record ID.	posts
rating	record's rating, defined as either "everyone", "mature", or "adult".	posts, projects, queue
files	related files by filename. can also be queried for length via files:length.	posts
updates	related files by filename. can also be queried for length via files:length.	projects, queue
srcfile	related source file by filename.	posts
tags	related tags by tag ID. it's usually easier to use tagged for this, as you can use the actual word with that.	posts, projects, queue
message	message value of record	comments
author	related author ID	posts, comments
tripfag	related tripfag by name. this must be an exact match.	comments
name	related name	comments

HIDDEN TAGS

---

by default, certain tags are hidden. to see these tags in your results, you must either edit your blacklist (found in the ADVANCED OPTIONS menu), which will be saved as a cookie, or add ~ to the front of any of the tags listed below.