Help:Portal
Talk0this wiki
Contents |
The portal and front pages are constructed out of multiple components. Each of these components can be edited individually and is auto-magically rendered with the right background.
Sections
Edit
The creation of containers and elements of the portal box is handled by {{PortalSection}}. It's design adds the necessary class so that the css can apply the correct style to the elements. You can move the elements about, but keep in mind that it might not look good unless you can also edit the common stylesheet, the wikia and the monobook specific stylesheet.
Transformer
Edit
{{PortalTransformer}} is the transformer that takes the layout and converts it into {{PortalSection}} much like our {{ItemTransformer}} does. It can also transform a portal section into a frameless section called a {{PortalPage}}.
Components
Edit
The following is a list of the components which can be used to make up a page. Simply transclude them into a page like so {{Portal:Component/News}}.
- Template:Portal/Component/News
- Template:Portal/Component/Forums
- Template:Portal/Component/Statistics
- Template:Portal/Component/Help
- Template:Portal/Component/Twitter, this #Twitter component contains special javascript
- Template:Portal/Component/Quotes
- Template:Portal/Component/FeaturedArticle
- Template:Portal/Component/Video, this component does not currently exist
- Template:Portal/Component/Images
- Template:Portal/Component/Activity
- Template:Portal/Component/NewestArticles
- Template:Portal/Component/Countdown, see the statistics component instead
- Template:Portal/Component/Poll
- Template:Portal/Component/Promotion, used occasionally
Portal Components
Edit
A portal is a unique type of component in that it is designed to fit within a certain width and height. It needs its fixed width as it is designed to be a tab in #Slider or as a standalone in the fallback #Portal Pages.
- Template:Portal/Main, this is a special page, see #Main Portal
- Template:Portal/Dragon Age: Origins
- Template:Portal/Dragon Age II
- Template:Portal/Dragon Age
- Template:Portal/Companions
- Template:Portal/Guides
Portal Pages
Edit
Portal pages are actual portals - if javascript fails and as a fallback position, Template:Portal/Main will link to each of these portal pages without sliding. Therefore, even though these pages are seldom used, they must be created in the event the user does not have javascript enabled, or if javascript fails to load.
These portal pages transclude #Layout and passes #Portal Components as a parameter. This basically tells wiki to use the layout but instead of using #Slider, use a static Portal Component instead.
The following is a list of Portal Pages
Layout
Edit
There is only one current layout for the page and it is Dragon Age Wiki - this wiki's main page. Its layout uses a unique component called the Template:Portal/Component/Slider unless it is transcluded and passed an anonymous {{{1}}} parameter. This page is only transcluded by #Portal Pages.
Slider
Edit
There is one unique component called Template:Portal/Component/Slider which is a component that consists of the other portal components. Its primary purpose is create a page with multiple pages of portal. Only Template:Portal/Main is shown and the rest is hidden. If javascript is enabled, then the user can slide through these pages. If javascript is not enabled, then clicking on links in the main page will take you to the #Portal Pages.
In order to add new pages, you must do two things
- Add the following code to the top of the page. X must be a number in the sequence.
<li>[[#portal_content-X]]</li>
- Add the following code to the middle part of the page. A content can be anything but should be a #Portal Components
<div id="portal_content-4" class="ui-tabs-hide">CONTENT HERE</div>
Twitter
Edit
There are two versions of Template:Portal/Component/Twitter.
The first version does not require any javascript, but it is unreliable. It uses the rss markup in Wikia which often fails to load.
The revamped Template:Portal/Component/Twitter calls MediaWiki:TwitterWidget. This in turn uses Twitter's Widget API to asynchronously update the feed. It is far more reliable. Use this version.
When creating this component using the second method, you will need to copy and edit MediaWiki:TwitterWidget.
Main Portal
Edit
The main portal is the first thing the reader sees when they enter the wiki as it is the first page of the #Slider. It should contain normal links to pages or portals.
In addition, if the link is to a #Portal Components, it should also contain
<div class="portal_sliderlink_X">CONTENT HERE</div>
If javascript is enabled, this will cause the code to slide to the page X instead of opening the portal. If javascript is not, then as a fallback, the user will be taken to that link location.
Random Pages
Edit
This page is here to distract you and cause confusion.
- Portal:Mockup
- Portal:Sandbox, when you absolutely have to tweak something without a right nav bar
Wiki
Edit
A few other wikis have adopted the use of Portal and the sliders. They are listed here.
- The Assassin's Creed Wiki
- The BioShock Wiki
- Deus Ex Wiki
- Elder Scrolls Wiki
- The Uncharted Wiki
- Prototype Wiki
- Reckoning Wiki
- GothicPedia
Versions
Edit
This is a change log. If you adopted the portal system prior to these dates, you will need to update your components accordingly.
v1.4 - 3rd October 2012
Edit
- Updated Template:Portal/Component/Images by adding padding on the right so it is now centered again
v1.3 - 11th September 2011
Edit
- Updated Template:Portal/Component/Chat so it now uses Wikia skin. This allows it to be loaded in monobook
- Updated MediaWiki:Common.js so that links to Special:Chat open in the default new window
- Moved all common styles from MediaWiki:Wikia.css to MediaWiki:Common.css
- Left skin specific overrides in MediaWiki:Wikia.css and MediaWiki:Monobook.css
v1.2.1 - 3rd September 2011
Edit
- Updated documentation with #Twitter. No component changed.
v1.2 - 16th August 2011
Edit
- Added Template:Portal/Component/Chat to use the new Special:Chat
v1.1 - 2nd June 2011
Edit
- Added MediaWiki:TwitterWidget
- Updated Template:Portal/Component/Twitter to use Twitter's official widget. This should result in less loading errors
- Updated MediaWiki:Wikia.css with styles corresponding to the new html elements
v1.0 - 7th November 2010
Edit
- Release