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
 
(15 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 15: Line 15:
The following parameters are crucial for querying.
The following parameters are crucial for querying.


*f_apply: The search engine action to apply. Accepted values (strings) are "Apply Filter" ([[galleries]]) and "Search Favorites" ([[favorites]]).
*f_search: The search query. Must be [https://en.wikipedia.org/wiki/Uniform_Resource_Identifier URI-compatible].
*f_search: The search query. Must be [https://en.wikipedia.org/wiki/Uniform_Resource_Identifier 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 [[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===
*inline_set: Changes the inline display mode.


*advsearch: Default value is 1. Toggles advanced searching and visibility of the advanced options panel. 0=disabled, 1=enabled.
Accepted values:
*page: Default value is 0. The zero-indexed page to jump to.
*dm_m: Minimal
*dm_p: Minimal+
*dm_l: Compact (default)
*dm_e: Extended
*dm_t: Thumbnail


===Categories===
===Categories===


Self-explanatory. Default value is 0 (disabled). Possible values: 0=disabled, 1=enabled.
*f_cats: Filters out categories using binary flags. Substracting the total from 1023 displays the categories instead.


Disabling all categories is the same as enabling all of them - it is not necessary to set everything to 1 if the goal is a full category search. (Don't set any filter 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


*f_doujinshi
===Favorites===
*f_manga
*f_artistcg
*f_gamecg
*f_western
*f_non-h
*f_imageset
*f_cosplay
*f_asianporn
*f_misc


===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, shows only 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. 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===
===File searching===
Line 52: 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.
 
===Galleries===


*f_sname: Enabled by default. Accepted value is "on". Searches for the f_search query in gallery names (titles).
Those parameters only apply inside of a gallery.
*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.
*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_srdd: Default value is 2 (it is enabled by default but will not work without f_sr). Accepted values are 2 to 5. Minimum gallery rating for results in stars; must be an integer. Ignored if f_sr is not set.
**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.

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.