Gallery Search Engine: Difference between revisions

From EHWiki
Jump to navigationJump to search
Luna Flina (talk | contribs)
mNo edit summary
Nasu (talk | contribs)
mNo edit summary
 
(9 intermediate revisions by 2 users not shown)
Line 9: Line 9:
*= (equals): Sets a GET argument/parameter's value if applicable. If omitted, the default value is used.
*= (equals): Sets a GET argument/parameter's value if applicable. If omitted, the default value is used.


If arguments are omitted, their default value is used/they are ignored. Some arguments have prerequisites to actually mean something (f_srdd, for example, is useless without f_sr=on, as it requires f_sr to activate a search by rating).
If arguments are omitted, their default value is used/they are ignored. Some arguments have prerequisites to be meaningful.


===Querying===
===Querying===
Line 18: Line 18:
*advsearch: Default value is 1. Toggles advanced searching and visibility of the advanced options panel for galleries. 0=disabled, 1=enabled.
*advsearch: Default value is 1. Toggles advanced searching and visibility of the advanced options panel for galleries. 0=disabled, 1=enabled.
*page: Default value is 0. The zero-indexed page to jump to.
*page: Default value is 0. The zero-indexed page to jump to.
===Search types===
At least one search type is required. Filters will be ignored if the corresponding search type is omitted.
*f_sname: Enabled by default. Searches for the f_search query in gallery titles.
*f_sdesc: Enabled by default. Searches for the f_search query in uploader [[comment]]s.
*f_stags: Enabled by default. Enables search by tags. Restricted to searchable tags by default.
**f_sdt1: Ignored by default or if f_sdt2 is set. Also searches for low-power tags.
**f_sdt2: Ignored by default. Also searches for low-power and downvoted tags.
*f_sr: Disabled by default. Enables search by rating (2-5).
**f_srdd: Ignored by default. Minimum gallery rating for results in stars.
*f_spf: Ignored by default. Sets the minimum amount of pages required for a gallery to be shown with this query.
*f_spt: Ignored by default. Sets the maximum amount of pages required for a gallery to be shown with this query.


===Viewing===
===Viewing===


*from: Automatic if required, can also be set manually. Discards galleries from the provided gallery ID (gid) for proper display of filtered results. Ignored where it would not have any effect.
*inline_set: Changes the inline display mode.
*inline_set: Changes the current inline mode view.


Accepted values:
Accepted values:
Line 33: Line 49:
===Categories===
===Categories===


*f_cats: Filters out categories you don't want to see using binary flags. Add them up to achieve the desired result. Cannot be higher than 1022 (hides everything but Misc); 1023 is the same as 0.
*f_cats: Filters out categories using binary flags. Substracting the total from 1023 displays the categories instead.


Flag values:
Flag values:
Line 49: Line 65:
===Favorites===
===Favorites===


No longer allows for fuzzy tag search at the moment due to performance issues. Also requires the user to specify at least one field to search for as there is no default field.
Requires the user to specify at least one argument as there is no default argument. If no argument is provided, the query will be ignored and all favorites will be displayed.


*favcat: Ignored by default (shows all favorites). Accepted values are 0 to 9. If provided, only searches in the specified favorite category.
*favcat: Ignored by default (shows all favorites). Accepted values are 0 to 9. If provided, only searches in the specified favorite category.
*sn: Disabled by default. Accepted value is "on". Searches for gallery titles matching the search query.
*sn: Disabled by default. Searches for gallery titles matching the search query.
*st: Disabled by default. Accepted value is "on". Searches for '''searchable''' gallery [[tags]] matching the search query.
*st: Disabled by default. Searches for '''searchable''' gallery [[tags]] matching the search query.
*sf: Disabled by default. Accepted value is "on". Searches for notes matching the search query.
*sf: Disabled by default. Searches for notes matching the search query.


===File searching===
===File searching===
Line 66: Line 82:
===Filters===
===Filters===


A valid f_search argument is required for all filters.
A valid f_search argument is required for all filters. The following filters are disabled by default.
 
*f_sto: Only returns galleries with torrents.
*f_sh: Shows expunged galleries.
*f_sfl: Ignores the user's language exclusion settings for this query.
*f_sfu: Ignores the user's uploader exclusion settings for this query.
*f_sft: Ignores the user's My Tags exclusion settings for this query.


*f_sname: Enabled by default. Accepted value is "on". Searches for the f_search query in gallery names (titles).
===Galleries===
*f_stags: Enabled by default. Accepted value is "on". Searches for the f_search query in gallery tags. Is restricted by f_sdt1 or f_sdt2 if provided. If neither is provided, searches for searchable tags.
*f_sdt1: Ignored by default. Accepted value is "on". Also searches for low-power tags. Requires f_stags to be applicable. Is implied when using f_sdt2 instead.
*f_sdt2: Ignored by default. Accepted value is "on". Also searches for downvoted tags. Requires f_stags to be applicable and includes low-power tags as well.
*f_sdesc: Enabled by default. Accepted value is "on". Searches for the f_search query in the gallery's description (uploader comment).
*f_storr: Disabled by default. Accepted value is "on". Searches for the f_search query in torrent filenames.
*f_sto: Disabled by default. Accepted value is "on". If set, only returns galleries with torrents.
*f_sh: Disabled by default. Accepted value is "on". Shows expunged galleries.


*f_sr: Ignored by default. Accepted value is "on". Must be set to "on" to enable search by rating. Required by f_srdd.
Those parameters only apply inside of a gallery.
*f_srdd: Default value is 2. Accepted values are 2 to 5. Minimum gallery rating for results in stars; must be an integer. Ignored if f_sr is not set.


*f_spf: Ignored by default (assumed to be any as in 1). Accepted values are 1-2000. Sets the minimum amount of pages required for a gallery to be shown with this query.
*hc: Disabled by default. Accepted value is 1. If enabled, shows [[comment]]s with a score of -50 or less. Clicking the corresponding option at the bottom of the page automatically adds a #comments anchor linking to the comment box. Changing pages will reset this.
*f_spt: Ignored by default (assumed to be any as in 2000). Accepted values are 1-2000. Sets the maximum amount of pages required for a gallery to be shown with this query.
**The #c<comment_id> anchor at the end of the URL will link to the corresponding comment ID. Using @<comment_id> in a comment will perform a comment mention and automatically add the corresponding anchor.
*longurls: Disabled by default, deprecated. If the longurls cookie is set to any value, uses the original long URLs when linking to a page (includes both width and height of the linked picture).
*nw: Disabled by default, used when visiting a content warning gallery if the cookie is not set. Accepted values: "session" and "always". Sets the cookie to 1 until the end of the session or for a duration of 1 year.


*f_sfl: Disabled by default. Accepted value is "on". If set, ignores the user's language exclusion settings for this query.
[[Category:E-Hentai Galleries]]
*f_sfu: Disabled by default. Accepted value is "on". If set, ignores the user's uploader exclusion settings for this query.
*f_sft: Disabled by default. Accepted value is "on". If set, ignores the user's My Tags exclusion settings for this query.

Latest revision as of 20:52, 11 June 2023

This is an article about detailed use of the search engine via the browser's address bar. For parent articles, please see E-Hentai Gallery System, Favorites and Gallery Searching.

Using PHP GET parameters

Basic guidelines

  • ? (question mark): Append this after a .php file (index.php is omitted; in this case append directly after the slash) to start declaring arguments, parameters and their respective values.
  • & (ampersand): Must be preceded by ? at the beginning of the declaration. Append this to declare additional arguments/parameters. You must add an ampersand for each new argument or parameter.
  • = (equals): Sets a GET argument/parameter's value if applicable. If omitted, the default value is used.

If arguments are omitted, their default value is used/they are ignored. Some arguments have prerequisites to be meaningful.

Querying

The following parameters are crucial for querying.

  • f_search: The search query. Must be URI-compatible.
  • advsearch: Default value is 1. Toggles advanced searching and visibility of the advanced options panel for galleries. 0=disabled, 1=enabled.
  • page: Default value is 0. The zero-indexed page to jump to.

Search types

At least one search type is required. Filters will be ignored if the corresponding search type is omitted.

  • f_sname: Enabled by default. Searches for the f_search query in gallery titles.
  • f_sdesc: Enabled by default. Searches for the f_search query in uploader comments.
  • f_stags: Enabled by default. Enables search by tags. Restricted to searchable tags by default.
    • f_sdt1: Ignored by default or if f_sdt2 is set. Also searches for low-power tags.
    • f_sdt2: Ignored by default. Also searches for low-power and downvoted tags.
  • f_sr: Disabled by default. Enables search by rating (2-5).
    • f_srdd: Ignored by default. Minimum gallery rating for results in stars.
  • f_spf: Ignored by default. Sets the minimum amount of pages required for a gallery to be shown with this query.
  • f_spt: Ignored by default. Sets the maximum amount of pages required for a gallery to be shown with this query.

Viewing

  • inline_set: Changes the inline display mode.

Accepted values:

  • dm_m: Minimal
  • dm_p: Minimal+
  • dm_l: Compact (default)
  • dm_e: Extended
  • dm_t: Thumbnail

Categories

  • f_cats: Filters out categories using binary flags. Substracting the total from 1023 displays the categories instead.

Flag values:

  • 1=Hide misc
  • 2=Hide doujinshi
  • 4=Hide manga
  • 8=Hide artistcg
  • 16=Hide gamecg
  • 32=Hide imageset
  • 64=Hide cosplay
  • 128=Hide asianporn
  • 256=Hide nonh
  • 512=Hide western

Favorites

Requires the user to specify at least one argument as there is no default argument. If no argument is provided, the query will be ignored and all favorites will be displayed.

  • favcat: Ignored by default (shows all favorites). Accepted values are 0 to 9. If provided, only searches in the specified favorite category.
  • sn: Disabled by default. Searches for gallery titles matching the search query.
  • st: Disabled by default. Searches for searchable gallery tags matching the search query.
  • sf: Disabled by default. Searches for notes matching the search query.

File searching

  • f_shash: Ignored by default. The SHA-1 file hash to search for.
  • fs_from: Ignored by default. The filename of the file that will be used to compare against. You must provide a file for this to work.
  • fs_similar: Default is 1. Toggles similarity search. 0=disabled, 1=enabled.
  • fs_covers: Default is 1. Toggles cover-only search. 0=any file, 1=cover only.
  • fs_exp: Default is 1. Toggles expunged gallery file searching. 0=disabled, 1=enabled.

Filters

A valid f_search argument is required for all filters. The following filters are disabled by default.

  • f_sto: Only returns galleries with torrents.
  • f_sh: Shows expunged galleries.
  • f_sfl: Ignores the user's language exclusion settings for this query.
  • f_sfu: Ignores the user's uploader exclusion settings for this query.
  • f_sft: Ignores the user's My Tags exclusion settings for this query.

Galleries

Those parameters only apply inside of a gallery.

  • hc: Disabled by default. Accepted value is 1. If enabled, shows comments with a score of -50 or less. Clicking the corresponding option at the bottom of the page automatically adds a #comments anchor linking to the comment box. Changing pages will reset this.
    • The #c<comment_id> anchor at the end of the URL will link to the corresponding comment ID. Using @<comment_id> in a comment will perform a comment mention and automatically add the corresponding anchor.
  • longurls: Disabled by default, deprecated. If the longurls cookie is set to any value, uses the original long URLs when linking to a page (includes both width and height of the linked picture).
  • nw: Disabled by default, used when visiting a content warning gallery if the cookie is not set. Accepted values: "session" and "always". Sets the cookie to 1 until the end of the session or for a duration of 1 year.