Links (WIP)

# Links > [!NOTE] > TODO - Write up introduction/purpose ## Adding links to entries You can currently add links to: Series, Works, Collections, and Publishers. Currently only Series have the full "Links V2" enabled on their pages and are more full-featured than the other types, but the criteria for deciding ### Link Types - **Retailer** – Where you buy the volumes. (Amazon, BookWalker, CDJapan) - **Publisher** – Official company or series landing page. No reader, just info. - **Webplatform** – Official online reader. (MangaPlus, Jump+, Webtoon) - **Info** – Wikis and databases. No trackers, just raw info. (Wikipedia, Fandom) - **Social** – Official social account for the series itself. Not the author's personal. - **News** – Anime/manga news outlets. (ANN, Crunchyroll News) - **Piracy** – Unofficial scans, raws, aggregators. - **Other** – Everything else. ### TODO - taxonomy-specific > [!NOTE] > TODO - everything else relating to general entry of links, per-series info, etc ## Link Domains [Link domains](https://mangabaka.org/mod/domains) allows moderators to define default categories for links, along with rewriting the urls entirely to handle defunct websites or extracting out the various unique series IDs to normalize the URLs so there aren't duplicates or tracking nonsense on the links. ### Display Name Criteria Display names are based on the logo rather than the domain itself, since that's technically how they want to promote or market themselves. If the language is English and if the logo is romanized in uppercase, it will be in uppercase as well. If the language is romanized japanese or kana, only the first letter gets capitalized. |Domain|Name from Logo|Display name| |---|---|---| flowercomics.jp | [フラコミlike!](https://flowercomics.jp/assets/logo.large.svg) | Flocomi like! kadokawa.co.jp | [KADOKAWA](https://static.kadokawa.co.jp/common/img/logo_kadokawa.png) | Kadokawa comic-days.com | [コミックDAYS](https://comic-days.com/_next/static/images/logo_days.b2a4bfef.svg) | Comic DAYS ### Status Types - **New** - When a domain is added from upstream or a user, but a moderator hasn't gotten around to it yet. - **Active** - A link should be marked active if it's been reviewed by a moderator to be accurate. - **Blocked** - Will prevent users from adding this link to series on the submission interface, and also hides it from the user-facing pages. - **Archived** - Will allow new entries to be added in the submission interface, but will not show it anywhere on the user-facing pages. Canonicalization Rules (see below) will only run if the status is set to New or Active. ### Parent Domains You can choose a domain to inherit all of its data from for defaults, and you can optionally use the "Inherit Parent Rules" checkbox to determine if Canonicalization Rules are inherited. You cannot currently choose another "child domain" as a parent. For example: - Domain A sets Domain B as its parent - Domain C **can** set Domain B as its parent - Domain C **cannot** set Domain A as its parent ### Default Type When someone is editing a Series to add a link to a page, it will default to "inherit" for the type. This allows setting the default that will be inherited assuming that a user doesn't override it in the form. > [!TIP] > The criteria for assigning default types are displayed in the Link Types section near the top of this documentation page. > [!WARNING] > At present there is no way to edit the default type based on url subpaths; For now you will have to choose the most common default. ### Default Language When someone is editing a Series to add a link to a page, it will default to "inherit" which pulls in the language set here. However you can also add a rule that extracts the "language" from the full URL then sets it based on regex. You can consider this dropbox to be the default language of the website, with path extraction handling the other cases, assuming it's not another subdomain entirely. ### Trust Level > [!NOTE] > TODO - why does trust level exist, and what changes based on trust level - **Blocked** - Fully block all links on this domain - **Untrusted** - Will display a warning in the user-facing pages that we can't confirm the contents of the page - **Neutral** - Relatively-safe thirdparty sites that might have other info for series, like Twitter - **Trusted** - Used for second-party sites that are known to be generally safe like major Retailers, or news sites that are more Legit - **Official** - First-party publisher websites, or webplatforms by the publishers themselves **Some examples:** - any piracy website - Blocked, linking to piracy websites is against mangabaka's rules. - web.archive.org - Untrusted, since it can be used to bypass all of the other link domains' criterias and can contain any other website inside of its links - x.com - Neutral, often used for series pages - www.amazon.co.jp - Trusted, main retailer - www.webtoons.com - Official, main publisher/webplatform for naver's english webcomics ### Favicon Override URL You can optionally choose a different url to serve the favicon on. This can be useful if a website is broken in some way and we need to fix the fetching of the icon, but in most cases this should be left blank. ### Include in Metrics Allowlist > [!NOTE] > TODO - What even is this ### Description / mod notes This box should ideally contain any special notes about the domain, like why it's okay to be "official", who owns the site, weird cases to keep in mind for rules, etc. Until link domains are added into the general submission system, moderators should also ideally enter in notes into this text box denoting what they changed and why they changed it. Since canonicalization rules don't have descriptions on them, it can be nice to write down what the rules handle or what they don't handle yet. ### Canonicalization Rules > [!NOTE] > TODO - Still writing up more examples These rules control how urls are rewritten after being pulled from upstream sources or after user submissions. This is primarily used to make sure we don't have duplicate urls in our system from users/upstream, but also to strip out tracking links > [!CAUTION] > If a domain is not set to New or Active then any rules for that domain will not run, including existing rules. > [!WARNING] > If a Rule is not listed on a domain's page, it won't run for that domain. This is especially important when rewriting the host of the URL to something else. After rewriting the URL it won't run any of the rules on that new URL's page, unless its a parent and "Inherit Parent Rules" are checked to have the rules show up on the child's page.