Mega Cool Author Page Tool Ver. 1.4.0

NOTICE:

This is a component page used internally by the SCP Wiki. It is intended to be used and included on other pages.

rating: +44+x

Introduction

Howdy there, and thank you for checking out this author page tool! This tool is designed to automatically update your author page with new pages and data, and provides support for additional pages, such as coauthored pages and foreign pages. Another tool similar to this one already exists on the wiki, and you can click here if you're interested in using it.

But Why?

I know that there's a tool like this already on the wiki. I still think that's really cool, of course! But there were some things that I'd like to see in that kind of tool that I've included in here. For starters, this tool includes variables such as upvote/downvote ratios, tags, and even translations! Additionally, there are a lot more customization options, such as toggling the floating effect or choosing the background.

Basically, there are plenty of differences between this tool and the other tool. There's definitely pros and cons to both; introducing another tool merely gives more options to select from.

Collapsibles

I'm putting this at the top so that you can see it before you try and implement it.

This tool will not work with standard collapsibles.

If you'd like to place this tool underneath a collapsible, you'll have to use the tool below:

[[include :scp-wiki:component:coltop show=SHOW TEXT |hide=HIDE TEXT]]
<content>
[[include :scp-wiki:component:colend]]

The reason this doesn't work is because the "Tags" and "Translations" sections of this are underneath collapsibles1, and because of complicated coding reasons, I can't use the collapsible thing I just showed you within the tool itself. Sorry ):

The Main Stuff

There are three components to this tool: the automatic page lister, the coauthored pieces section, and the foreign articles section. The first one is automatic, and includes most of the pages you'll make on the site.

Here's the base code you'll need to include, and I'll explain what each variable does below:

[[include :scp-wiki:component:mega-cool-author-page-tool |inc-list= --]
|order=
|perpage=
|background-image=
|shadow=
]]

|order= The order you want your articles to be in. Use one of the following variables for whichever results you'd like:

  • name: Order alphabetically by page URL.
  • title: Order alphabetically by page title.
  • rating: Order by rating.
  • created_at: Order by time created.

You can put any of these in reverse order simply by adding "desc" afterwards (e.g. "rating desc").

|perpage= The number of articles of each category you want per page. Default is 20, maximum is 250.

|background-image= If you'd like to have a background image or logo when you hover over entries, paste a link to the image you'd like. If you'd like to use a simple Foundation logo, you can use the one here. If you leave it blank, no image will show up.

|shadow= By default, whenever you hover your mouse over an entry, the entry will "pop out" slightly. If you don't want it to do this, put "no" or "false" here.

I've shown an example of how this might look below, using the most recently created articles on the site. These are ordered by time created.

Recent Pages

(Random)


Touch Grass (or, an Essay on How Not to Spend the Best Years of Your Life Arguing on the Internet)


Rating: +3
Comments: 0
+/- : +4/-1
Last Comment: ()
Last Edit: OptimisticLucio (28 Mar 2024 21:11)

SCP-3169


Rating: +6
Comments: 1
+/- : +6/-0
Last Comment: PoufyPoufson (28 Mar 2024 20:50)
Last Edit: PoufyPoufson (28 Mar 2024 20:50)

Art Tagging Guide


Rating: +3
Comments: 0
+/- : +3/-0
Last Comment: ()
Last Edit: Jerden (28 Mar 2024 20:55)

Critter Profile: Reggie


Rating: +4
Comments: 0
+/- : +5/-1
Last Comment: ()
Last Edit: Uncle Nicolini (28 Mar 2024 19:10)

Wasabi Hub


Rating: +3
Comments: 1
+/- : +3/-0
Last Comment: fluxman (28 Mar 2024 14:09)
Last Edit: fluxman (28 Mar 2024 14:10)

There are multiple values and sections here, and I'll go through each one of them really quickly.

(Random): Selects a random article of that category.

Rating and Comments: The rating and the number of comments, respectively.

+/-: This is the ratio of upvotes to downvotes. For instance, a value of "+8/-2" would mean that the article has 8 upvotes and 2 downvotes.

Last Comment: The name of the user who gave the last comment and when it was posted.

Last Comment: The name of the user who last edited the page and when it was done.

Tags: Can open a list of all visible tags on the article, with links to each tag page.

Translations: Can open a list of all translations of the article.

Coauthored Articles

One thing that the tool above doesn't include is coauthored pages. Coauthored pages using this module are uploaded manually, although they're each easy and simple to upload. The reason they're not included with the standard updater is for two reasons. First, you can't attribute coauthor credit. Second, if you have multiple coauthored pages, there's a chance that some of those pages were uploaded by you and some by your coauthor, and only the ones that were uploaded by you would actually show up on the module. This means that you'd be forced to either split all coauthored pages between the standard module and the coauthored module, or you'd have duplicates of articles on the main module in the coauthored section.

If you have coauthored pages, first, place this module above where you want your coauthored pages:

[[include :scp-wiki:component:mega-cool-author-page-tool |inc-coauthor-header= --]]]

Then, you'd need to use one of these for every one of your coauthored pieces:

[[include :scp-wiki:component:mega-cool-author-page-tool |inc-coauthored= --]
|name=
|feat=
|language=
]]

This one only has three variables needed, since everything else should already be covered by the standard tool that's already on your page.

|name= This is the portion of the URL link that specifies your page on the site. It is not the actual title of the article. For instance, instead of putting "Periapsis," for this page, you would put "scp-4391".

|feat= List all of the coauthors for the page here, except yourself.

|language= Same as the one above, it's the two-letter lowercase ID for the article's language.

Here's an example of one of my own coauthored pieces, with CityToast:

Co-Authored


SCP-194 (feat. CityToast)


Rating: +70
Comments: 15
+/- : +107/-37
Last Comment: The Void Engineer (05 Mar 2024 05:00)
Last Edit: Ralliston (21 Feb 2023 20:50)

Foreign Articles

While I'm sure this only covers a small portion of your, some folks write not only for this branch of the wiki, but also for a different language branch! Naturally, you should be free to take credit for those as well.

Foreign articles are a bit trickier to implement. One of the biggest issues is that any article of yours that you've written on a different translation site will be hosted on a different site from the site your author page is on. This means that we can't use ListPages to return things like ratings, comments, or tags. The only things showing up here, sadly, will be the article link, a link to a translation, and the list of translations. Ironically, it has the most variables out of anything, since it involves some cross-site magic.

Include this module above where you want your foreign articles:

[[include :scp-wiki:component:mega-cool-author-page-tool |inc-foreign-header= --]]]

Then, include this piece of code for every one of your foreign articles:

[[include :scp-wiki:component:mega-cool-author-page-tool |inc-foreign= --]
|name=
|link=
|title=
|translation=
|language=
]]

|name= The name of the article. Again, not the title, but the name from the URL link. If your page is hosted on the Underrepresented Languages Incubator, then only include the portion of the URL after the page category. For instance, if your page slug is "la:scp-la-xxx," then you would only include "scp-la-xxx".

|link= A link to the original article.

|title= This is where the actual title goes.

|translation= A full link to the translation in the language of your site. For example, if you're on the -EN wiki and have written a -CN article which was translated onto the -EN wiki, you'd include a link to the English translation on the -EN wiki. If you don't have a translation available, put "no".

|language= The name of the language the original article is in. For example, if you're including an article from the -FR branch, put "French".

The reason for all these variables is to ensure that the one thing that does work, the translation module, will fully function properly. Since ListPages can't access other sites, a lot more stuff has to be put in manually.

Here's an example of how it would look using SCP-488-JP, if the original author had made an author page on the -EN wiki.

Foreign


Manual Component

The auto-updater isn't a perfect tool, sadly. If you've deleted your account previously, or if you've written articles for someone else, this tool likely won't function properly. You might also not like it for other reasons! Maybe you don't like how the categories are divided up, or there are some pages you'd like to leave off, or whatever.

If you'd like to include all the information that comes with this module, but you don't want to use the auto-updater, you're covered!

For every category of articles you'd like to show, place this code block above where the articles will go:

[[include :scp-wiki:component:mega-cool-author-page-tool |inc-manual-header= --]
|category=
|tags=
]]

|category= This is the header that will go above the list of articles. On the auto-updating list, there are four categories: SCPs, Tales, GoI Formats, and Others. Place the category of all the articles that will go below this. For instance, if you're including all your articles featuring the GOC in this section, you might put "GOC Articles," or if you're including all the theme pages you've made, you might put "Theme Pages". If you're not dividing your articles up at all, you could just put "Articles".

|tags= This is used for the "Random" button beneath the header. Basically, it includes all the tags that are shared by articles in this category and are written by you, which this button will then randomly select from when you click it. List out any tags you want it to select from in a space-separated list of tags, each of the prefaced by a "+". If you want to be sure that certain articles are excluded, include those tags prefaced by a "-". For instance, if you wanted to include any pages related to Doctor Wondertainment, but which aren't SCP articles, you would put "+dr-wondertainment -scp". If you don't want a random button at all, you can simply leave this variable blank. If you want it to randomly select from all your articles, put "-author".

Next are the manual entries. For every one of your articles, include this block:

[[include :scp-wiki:component:mega-cool-author-page-tool |inc-manual-list= --]
|name=
|background-image=
|language=
|shadow=
]]

Pretty much all of these variables are covered above, with the normal module! The only difference is that you now have to include the name of the article itself. If you want to include coauthored or foreign pages, you can use the tools above, with or without the big "Co-Authored" and "Foreign" headers if you'd prefer.

Custom Listing

For those of you who like the automatic updating feature, but dislike the categories the default tool is separated into, or maybe want to split their articles across multiple tabs or organize them differently, this tool is for you. The Custom Listing tool allows you to choose how your articles will be organized using a tag-based system, without forcing you to manually update it.

To use it, implement the following code:

[[include :scp-wiki:component:mega-cool-author-page-tool |inc-custom-list= --]
|background-image=
|language=
|order=
|perpage=
|shadow=
|category=
|tags=
]]

All of these variables work the same as explained above. However, unlike in the manual tool, the tags field is required. Fill this out with the tags you want to include (+tag-name) and exclude (-tag-name), space separated.

Page Titles/Descriptions

One of the greatest shortcomings of tools like this is that you can't include things like SCP titles or page descriptions. That has remained a major flaw that has proved difficult to fix… until now! With the latest in weird stuff that honestly isn't revolutionary at all, you can now choose to have SCP titles or page descriptions on your entries. To do so, include the following code block on any page you want to pull a subtitle or description from:

[[div style="display:none;"]]
--]TEXT[!--

--]
[[/div]]

Note that this code block must go above all other content on the page in order for the tool to pull the title. This include the rating module, include blocks, and CSS code. Not including this code or placing it below any other content will not break your page or the author page tool, it will simply not display the subtitle or description on the tool.

After you've placed the above code block on your page, simply replace "TEXT" with whatever text you choose. Note that this can only be a single paragraph; trying to include more than one paragraph will not work and may break things. The title pull works with the automatic component, the coauthor component, and the manual component, but it does not work with the foreign component.

Here is an example of how an SCP title might look with this:

SCP-4645

Blackmailing Computer


Rating: +440
Comments: 56
+/- : +456/-16
Last Comment: DrScaramouche (19 Jul 2022 21:25)
Last Edit: Calibold (23 Feb 2024 02:52)

Alternatively, if you want to include a complete page description, here's how that might look:

Ulysses B. Donkman and the Heinous Hitman

Dozens of people have gathered together this day, and all but one of them weeps in distress. Today, they mourn the death of a true hero. Ulysses B. Donkman has been slain.


Rating: +31
Comments: 4
+/- : +32/-1
Last Comment: Genshed (25 Feb 2020 19:46)
Last Edit: DrLeviStarkin (27 Feb 2024 17:46)

If you are have any issues or concerns with this tool, send a Wikidot PM to CaliboldCalibold, or leave a comment on this page! Good luck, and happy skipping!

rating: +44+x
Unless otherwise stated, the content of this page is licensed under Creative Commons Attribution-ShareAlike 3.0 License