Skin:Cosmos
Cosmos Release status: stable |
|||
---|---|---|---|
![]() |
|||
Description | Cosmos is a skin designed and based off Fandom's Oasis skin. Designed to improve upon their design, and provide an efficient MediaWiki skin for non-Fandom users, or for users transitioning out of Fandom. | ||
Author(s) | Universal Omega SamanthaNguyen |
||
Latest version | 4.8.4 (2021-01-16) | ||
MediaWiki | 1.35.0+ | ||
License | GNU General Public License 2.0 or later | ||
Download | README.md Join the Cosmos Discord server if you require immediate assistance, or create a task on Phabricator about it (link below). |
||
Example | mwcosmos.com | ||
|
|||
Translate the Cosmos skin if it is available at translatewiki.net | |||
Check usage and version matrix; | |||
Issues : | Open tasks · Report a bug |
Cosmos is a skin designed and based off Fandom's Oasis skin. Designed to improve upon their design, and provide an efficient MediaWiki skin for non-Fandom users, or for users transitioning out of Fandom. If you would like to learn how to contribute, please read our guide.
InstallEdit
- Download and place the file(s) in a directory called
Cosmos
in yourskins/
folder. - Add the following code at the bottom of your LocalSettings.php:
wfLoadSkin( 'Cosmos' );
- Configure as required.
- Done - Navigate to Special:Version on your wiki to verify that the skin is successfully installed.
ConfigurationEdit
These settings will apply when Cosmos is the active skin.
Option | Type | Default value | Requires | Documentation |
---|---|---|---|---|
$wgCosmosBannerBackgroundColor
|
String; color name or hex code | #c0c0c0 | Changes the background color of the top banner (the one with the personal tools drop-down). | |
$wgCosmosBannerLogo
|
String; full URL | null | Sets a logo to appear in the top banner next to the search input field. (deprecated) | |
$wgCosmosWikiHeaderWordmark
|
String; full URL |
|
Adds a wordmark to the wiki header (the one with the site navigation links) (deprecated) (in a future version of cosmos, this may only support $wgLogos )
| |
$wgCosmosWikiHeaderBackgroundImage
|
String; full URL | null | Adds a background image to the wiki header (the one with the site navigation links); blends image with header colors using gradient. | |
$wgCosmosWikiHeaderBackgroundColor
|
String; color name or hex code | #c0c0c0 | Changes the background color of the wiki header (the one with the site navigation links); $wgCosmosWikiHeaderBackgroundImage uses this to blend the image to this color, if the image is set.
| |
$wgCosmosBackgroundImage
|
String; full URL | null | Adds a background image to the page body (behind the content area); effectively nullifies $wgCosmosMainBackgroundColor , as the image would cover the color.
| |
$wgCosmosMainBackgroundColor
|
String; color name or hex code | #1A1A1A | Adds a background color to the page body (behind the content area); effectively nullified by $wgCosmosBackgroundImage , as the image would cover the color.
| |
$wgCosmosContentBackgroundColor
|
String; color name or hex code | #ffffff | Changes the background color of the main wiki article content area and the Cosmos sidebar (if MediaWiki:Cosmos-customsidebar is set); $wgCosmosContentOpacityLevel uses this to create an RGBA styled background color-opacity level.
| |
$wgCosmosBackgroundImageSize
|
String; auto, contain, or cover | cover | $wgCosmosBackgroundImage set;
|
Sets the background image size for the body background if set; while the string accepts all values, it's recommended to use one of the following: auto, contain, or cover. |
$wgCosmosLinkColor
|
String; color name or hex code | #0645ad | Changes the color of links in the cosmos wiki article area and the cosmos sidebar (if MediaWiki:Cosmos-customsidebar is set). | |
$wgCosmosButtonColor
|
String; color name or hex code | #c0c0c0 | Changes the background color of the page action buttons for Cosmos; also sets PortableInfobox coloring through blending if the extension is installed. | |
$wgCosmosToolbarColor
|
String; color name or hex code | #000000 | Changes the background color of the floating toolbar at the bottom. | |
$wgCosmosFooterColor
|
String; color name or hex code | #c0c0c0 | Changes the background color of the footer; the footer always has an opacity of 0.8, so this variable is converted to RGBA to set this opacity. | |
$wgCosmosBackgroundImageRepeat
|
Boolean | false | $wgCosmosBackgroundImage set;
|
if true the background image will be set to 'repeat' otherwise, if false, it will be set to 'no-repeat'. |
$wgCosmosBackgroundImageFixed
|
Boolean | true | $wgCosmosBackgroundImage set;
|
If true the background image will be set to position: fixed; .
|
$wgCosmosContentOpacityLevel
|
Integer; in percentage, without the percent symbol (%) | 100 | $wgCosmosContentBackgroundColor set;
|
Set the content area background opacity in percentage (without the percent symbol (%). |
Extension configuration settingsEdit
SocialProfileEdit
These configuration settings require SocialProfile to be installed in order to use them.
Option | Type | Default value | Requires | Documentation |
---|---|---|---|---|
$wgCosmosSocialProfileAllowBio
|
Boolean | true | Allows users to add a bio to display on their user pages, through Special:MyPage/bio. | |
$wgCosmosSocialProfileModernTabs
|
Boolean | true | Enables a modern version of the tabs on SocialProfile profile pages. | |
$wgCosmosSocialProfileRoundAvatar
|
Boolean | true | Makes the avatar round on SocialProfile profile pages. | |
$wgCosmosSocialProfileShowEditCount
|
Boolean | true | Show's the edit count and registration date for the user on SocialProfile profile pages, underneath their username. | |
$wgCosmosSocialProfileShowGroupTags
|
Boolean | true | $wgCosmosNumberofGroupTags set and more then zero; $wgCosmosProfileTagGroups set with at least 1 usergroup in the array
|
Enables usergroup tags to appear next to user's username on SocialProfile profile pages. |
$wgCosmosUseSocialProfileAvatar
|
Boolean | true | Use SocialProfile avatar as avatar next to username in top banner (the banner with the personal tool drop-down). If user doesn't have an avatar and this is set, will use the default SocialProfile avatar. | |
$wgCosmosProfileTagGroups
|
Array | [ 'bureaucrat', 'bot', 'sysop', 'interface-admin', 'suppressor' ] | $wgCosmosNumberofGroupTags set and more then zero; $wgCosmosSocialProfileShowGroupTags set as true
|
Array of usergroups to show on SocialProfile pages if the user has them. |
$wgCosmosNumberofGroupTags
|
Integer | 2 | $wgCosmosProfileTagGroups set with at least 1 usergroup in the array; $wgCosmosSocialProfileShowGroupTags set as true
|
Set the max number of group tags to show on a user's SocialProfile page if they have them. |
PortableInfoboxEdit
These configuration settings require PortableInfobox to be installed in order to use them.
Option | Type | Default value | Requires | Documentation |
---|---|---|---|---|
$wgCosmosEnablePortableInfoboxEuropaTheme
|
Boolean | true | $wgCosmosButtonColor set;
|
Enables the Europa theme from Fandom's portable infobox extension on the ported extension. |
InterfaceEdit
- MediaWiki:Cosmos-tagline
- Modifies the sitename text in the wiki header. Defaults to the value of MediaWiki:Sitename.
- MediaWiki:Cosmos-customsidebar
- creates a custom sidebar. If the MediaWiki message is empty, contains only white space, contains only a "-", or is non-existent, the sidebar will be completely hidden.
- MediaWiki:Cosmos-stickysidebar
- creates a custom sticky sidebar. If the MediaWiki message is empty, contains only white space, contains only a "-", or is non-existent, the sidebar will be completely hidden.
- MediaWiki:Cosmos-navigation
- Modifies the site navigation for this skin; defaults to MediaWiki:Sidebar, although it is recommended to copy MediaWiki:Sidebar to MediaWiki:Cosmos-navigation and follow the Cosmos navigation format for the best results. This navigation can be up to 3 levels deep, and allows a few variables to be used:
{$NEWVIDEOS_CONDITIONAL}
(alternatively,{$NEWVIDEOS}
) will display a link to Special:NewVideos only when the Video extension is enabled.{$WANTEDPAGES_CONDITIONAL}
(alternatively,{$WANTEDPAGES}
) will display a link to Special:WantedPages only when the Video extension is not enabled.{$WANTEDPAGES_FORCE}
will display a link to Special:WantedPages regardless of if the Video extension is enabled or not.
The navigation should be in the format of:
*#|Community **mainpage|mainpage-description **recentchanges-url|recentchanges **portal-url|portal *link|Tab title/level one **Level 2 tab title ***Level 3 content 1 *cosmos-explore **recentchanges-url|recentchanges **randompage-url|randompage **Special:NewFiles|cosmos-newfiles {$NEWVIDEOS_CONDITIONAL} {$WANTEDPAGES_CONDITIONAL}
and, defaults to:
{{int:Sidebar}} *cosmos-explore **recentchanges-url|recentchanges **randompage-url|randompage **Special:NewFiles|cosmos-newfiles {$NEWVIDEOS_CONDITIONAL} {$WANTEDPAGES_CONDITIONAL}
Compatibility and notesEdit
- As of version 4.0.0, Cosmos supports MediaWiki 1.36.
- Cosmos uses the Special:Statistics article count, therefore changing
$wgArticleCountMethod = 'any';
and afterwards running maintenance/UpdateArticleCount.php will make that counter use all content pages.- Counter will not display at all if user does not have the
read
userright.
- Counter will not display at all if user does not have the
- An "Admin Dashboard" icon will appear if the AdminLinks extension is enabled and you have the needed right (adminlinks).
- Links to Special:AddVideo will appear if the Video extension is enabled and you have the needed right (addvideo).
- Cosmos uses cookies for the sitenotice by default. If the DismissableSiteNotice extension is enabled, then Cosmos will convert to that extension instead.
- Cosmos supports Echo notifications. If the Echo extension is enabled and the user is logged in then Cosmos will display notification icons next to the personal tools menu.
- Cosmos has a create article method to easily create articles through a popup.
- Will not appear if user does not have both the
edit
andcreatepage
rights.
- Will not appear if user does not have both the
- When Cosmos is installed, there will be a preference that will be available upon the selection of the Cosmos skin, allowing to toggle the mobile responsiveness of Cosmos. Enabled by default.
- Cosmos does not support the DarkMode extension, therefore removes it from the personal tools when it's enabled.
- Cosmos supports Miraheze's ManageWiki extension. It will adhere to the
managewikisidebar
preference, and if that is on, it will display manage wiki links in the navigation. - Cosmos is tested and works with VisualEditor.
- There are body classes for the main page and whether a user is logged in or not.
Planned featuresEdit
- Some configuration options will be removed. (Listed as deprecated above)
- Configuration to change content area width is planned.