0degreesk: Created page with "These are the steps that I took to customize this installation of [http://www.mediawiki.org/wiki/MediaWiki MediaWiki] (v. 1.15.2 – 2010-03-08) on the [http://www.hostmonster..."

2020-09-21T01:19:04Z

Created page with "These are the steps that I took to customize this installation of [http://www.mediawiki.org/wiki/MediaWiki MediaWiki] (v. 1.15.2 – 2010-03-08) on the [http://www.hostmonster..."

New page

These are the steps that I took to customize this installation of [http://www.mediawiki.org/wiki/MediaWiki MediaWiki] (v. 1.15.2 – 2010-03-08) on the [http://www.hostmonster.com/ HostMonster] web hosting service.

==Summary==
This is a '''public''', '''read-only''' wiki with the ability for users to upload files. "Short URL" functionality is enabled and InterWiki links are used to link to my private wiki at http://wiki.unionandparkwood.com.
* All content is viewable by the public
* User registration is forbidden
* File upload is permitted by users only
* "Short URL" functionality is enabled
* InterWiki links are allowed with http://wiki.unionandparkwood.com/
* Update site logo

==Initial LocalSettings.php File Details==
The following lines of code must be '''added''' to the <tt>LocalSettings.php</tt> file, preferably at the bottom of the existing code so that it's easy to remember what was added. (For more configuration settings, see "[http://www.mediawiki.org/wiki/Manual:Configuration_settings MediaWiki Manual:Configuration Settings]".)

1) Setting the location of the favicon.ico manually (because it wasn't updating correctly at first)
<pre>
# Setting the location of the favicon.ico manually
$wgFavicon = "http://wiki.60bpm.com/favicon.ico";
</pre>

2) Prevent editing of pages by anyone except sysops
<pre>
# Prevent editing of pages by anyone except sysops
$wgGroupPermissions['*']['edit'] = false;
$wgGroupPermissions['user']['edit'] = false;
$wgGroupPermissions['sysop']['edit'] = true;
</pre>

3) Prevent new user registrations except by sysops
<pre>
# Prevent new user registrations except by sysops
$wgGroupPermissions['*']['createaccount'] = false;
</pre>

4) Update the logo path to point to my custom logo
<pre>
# Add customized logo to skin
$wgLogo = "/siteflow/images/60bpmlogo.png";
</pre>

==Allow File Uploading==
Modify permissions for the <tt>/images/</tt> directory in the docroot to allow writing.

===LocalSettings.php File Edits===
Allow file uploads. '''NOTE:''' this variable already exists in the <tt>LocalSettings.php</tt> file and only needs to be changed.
<pre>
$wgEnableUploads = true;
</pre>

Just below this change, I add the following to allow more file types to be uploaded:
<pre>
# Allow the following file types to be uploaded
$wgFileExtensions = array('png', 'gif', 'jpg', 'jpeg', 'pdf', 'bmp', 'svg', 'psd', 'ai', 'mp3', 'mp4', 'm4v');
</pre>

==Short URL Activation==
The MediaWiki "[http://www.mediawiki.org/wiki/Pretty_URL#Recommended_how-to_guide_.28setup_used_on_Wikipedia.29 Manual:Short URL -- Recommended How-To Guide]" on enabling Short URLs could not be used because my web host ([http://www.hostmonster.com/ HostMonster]) does not allow root access to the <tt>httpd.conf</tt> file. Instead, I had to use the "[http://www.mediawiki.org/wiki/Manual:Short_URL/wiki/Page_title_--_no_root_access Manual:Short URL -- no root access]" guide which uses the <tt>.htaccess</tt> file.

===LocalSettings.php File Edits===
<pre>
# Virtual path (left part of first rewrite rule). MUST be DIFFERENT from the path set above ($wgScriptPath)!
$wgArticlePath = "/article/$1";
$wgUsePathInfo = true;
</pre>

===.htaccess File===
<pre>
Options +FollowSymlinks
RewriteEngine On
RewriteRule ^article/(.*)$ /index.php?title=$1 [PT,L,QSA]
RewriteRule ^article/*$ /index.php [L,QSA]
RewriteRule ^/*$ /index.php [L,QSA]
</pre>
NOTE: The <tt>Options +FollowSymlinks</tt> portion is not in the MediaWiki guide, but the code wasn't working without it. I did a search and found [http://helpdesk.hostmonster.com/index.php/kb/article/000198 this article] in the HostMonster Support Center, which said that "+FollowSymLinks must be enabled for any rules to work."

==Allowing InterWiki Links==
This was enabled so that I could keep my private content in this wiki and my public content for 60bpm, and link back and forth within them. To accomplish this, I followed the [http://www.mediawiki.org/wiki/Manual:Interwiki MediaWiki InterWiki Manual].

1) Perform the following insert into the <tt>mw_interwiki</tt> table of the wiki database.
<pre>
INSERT INTO mw_interwiki SET iw_prefix='up', iw_url='http://wiki.unionandparkwood.com/article/$1', iw_local=1, iw_trans=0;
</pre>

==Style Updates==
All style updates are made in the current skin directory. At the moment, this is: <tt>/skins/monobook/main.css</tt>

1) I prefer that the visited links are colored the same as the original links
<pre>
a, a:visited {
text-decoration: none;
color: #002bb8;
background: none;
}
/* I prefer that the visited links are colored the same as the original links
a:visited {
color: #5a3696;
}
*/
</pre>
==Extensions==
The extensions that I've added to this wiki are as follows.
===Cite===
[http://www.mediawiki.org/wiki/Extension:Cite Extension:Cite] is method of dynamically adding footnotes to an article. The extension code was uploaded to <tt>/extensions/Cite/</tt>. The following code was added to the <tt>LocalSettings.php</tt> file:
<pre>
# Here are the includes for my added extensions
require_once("$IP/extensions/Cite/Cite.php");
</pre>
===EmbedVideo===
[http://www.mediawiki.org/wiki/Extension:EmbedVideo] is a method of easily embedding a video from a variety on video hosting sites. The extension code was uploaded to <tt>/extensions/VideoEmbed/</tt>. The following code was added to the <tt>LocalSettings.php</tt> file:
<pre>
#EmbedVideo
require_once("$IP/extensions/EmbedVideo/EmbedVideo.php");
</pre>
===Infobox Data Capture===
I originally thought that this extension was all I needed to add the right-aligned album info, but this wasn't the case. Regardless, I'm keeping this here for now.

[http://www.mediawiki.org/wiki/Extension:Infobox_Data_Capture Extension:Infobox Data Capture] is a method of adding a right-aligned column of formatted data to an article. This was installed for the music collection pages. The [http://www.mediawiki.org/wiki/Extension:Infobox_Data_Capture#Code extension code] was captured and uploaded to <tt>/extensions/InfoboxData/</tt>. The following code was added to the <tt>LocalSettings.php</tt> file:
<pre>
require_once("$IP/extensions/InfoboxData/InfoboxData.php");
</pre>
The following database query was performed to create the needed table:
<pre>
CREATE TABLE `mw_infoboxdata` (
`ib_from` int(8) unsigned NOT NULL default '0',
`ib_datablock_order` int(11) NOT NULL default '7',
`ib_datablock_name` varbinary(255) NOT NULL default '',
`ib_attribute_order` int(11) NOT NULL default '7',
`ib_attribute` varbinary(255) NOT NULL default '',
`ib_value` blob,
`ib_isvalid` int(1) unsigned NOT NULL default '1',
`ib_comment` blob,
KEY `ib_from` (`ib_from`,`ib_datablock_order`,`ib_datablock_name`,`ib_attribute`),
KEY `ib_datablock_name` (`ib_datablock_name`,`ib_from`)
) ENGINE=MyISAM DEFAULT CHARSET=binary;
</pre>

===Infobox===
The '''Infobox''' extension actually required the installation of the '''ParserFunctions''' extension, followed by the creation of a large number of templates. The reason I wanted to install this functionality was so that I could add the details of albums and musical collections to the right of the other information.

For details on how to use this functionality, see [http://en.wikipedia.org/wiki/Template:Infobox_album Wikipedia's Template:Infobox album] page.

I needed some direction to do this, so I followed along with this tutorial: [http://www.etcwiki.org/wiki/Mediawiki_template_guide '''ETCwiki''': How to install template infobox in mediawiki].

1) Uploaded the [http://www.mediawiki.org/wiki/Extension:ParserFunctions Extension:ParserFunctions] extension to <tt>/extensions/ParserFunctions/</tt> and added the following to the <tt>LocalSettings.php</tt> file:
<pre>
require_once("$IP/extensions/ParserFunctions/ParserFunctions.php");
$wgPFEnableStringFunctions = true;
</pre>

2) Search for [[MediaWiki:Common.css]], then create the page and add the styles. The added styles are currently on this page, between the following comments:
<pre>
/***************************
INFOBOX STYLES BEGIN HERE
***************************/
...

/***************************
INFOBOX STYLES END HERE
***************************/
</pre>

3) The following templates were recommended by the tutorial. I'm not currently sure if all of this was necessary. After installing them all, it dawned on me what I was doing and then how to find more templates I needed.

To install a template: Search, create, paste source code and save.

These are the first level of templates you need for Template:Infobox
* Template:! [http://www.etcwiki.org/index.php?title=Template:!&action=edit view source]
* Template:Clear [http://en.wikipedia.org/w/index.php?title=Template:Clear&action=edit view source]
* Template:Documentation [http://en.wikipedia.org/w/index.php?title=Template:Documentation&action=edit view source]
* Template:Documentation subpage [http://en.wikipedia.org/w/index.php?title=Template:Documentation_subpage&action=edit view source]
* Template:Documentation/docname [http://en.wikipedia.org/w/index.php?title=Template:Documentation/docname&action=edit view source]
* Template:Infobox [http://en.wikipedia.org/w/index.php?title=Template:Infobox&action=edit view source] (you may already have this)
* Template:Infobox/doc (edit)
* Template:Intricate template [http://en.wikipedia.org/w/index.php?title=Template:Intricate_template&action=edit view source] - Really Important*
* Template:Navbar [http://en.wikipedia.org/w/index.php?title=Template:Navbar&action=edit view source]
* Template:Nowrap [http://en.wikipedia.org/w/index.php?title=Template:Nowrap&action=edit view source]
* Template:Ombox [http://en.wikipedia.org/w/index.php?title=Template:Ombox&action=edit view source]
* Template:Ombox/core [http://en.wikipedia.org/w/index.php?title=Template:Ombox/core&action=edit view source]
* Template:Pp-meta [http://en.wikipedia.org/w/index.php?title=Template:Pp-meta&action=edit view source]
* Template:Pp-template [http://en.wikipedia.org/w/index.php?title=Template:Pp-template&action=edit view source]
* Template:Purge [http://en.wikipedia.org/w/index.php?title=Template:Purge&action=edit view source]
* Template:Tl [http://en.wikipedia.org/w/index.php?title=Template:Tl&action=edit view source] (this is TL, I had trouble telling the L in lowercase)
* Template:Tnavbar [http://en.wikipedia.org/w/index.php?title=Template:Tnavbar&action=edit view source]
* Template:Transclude [http://en.wikipedia.org/w/index.php?title=Template:Transclude&action=edit view source]

You will also need to copy these templates to make the ones above work
* Template:Infobox/row [http://en.wikipedia.org/w/index.php?title=Template:Infobox/row&action=edit view source]
* Template:Tiw [http://en.wikipedia.org/w/index.php?title=Template:Tiw&action=edit view source]
* Template:Tlf [http://en.wikipedia.org/w/index.php?title=Template:Tlf&action=edit view source]
* Template:Tls [http://en.wikipedia.org/w/index.php?title=Template:Tls&action=edit view source]
* Template:Tlsp [http://en.wikipedia.org/w/index.php?title=Template:Tlsp&action=edit view source]
* Template:Tlp [http://en.wikipedia.org/w/index.php?title=Template:Tlp&action=edit view source]
* Template:Tn [http://en.wikipedia.org/w/index.php?title=Template:Tn&action=edit view source]
* Template:Tlx [http://en.wikipedia.org/w/index.php?title=Template:Tlx&action=edit view source]
* Template:Mbox Templates [http://en.wikipedia.org/wiki/Template:Mbox_templates view source]
* Template:Mbox templates/doc [http://en.wikipedia.org/w/index.php?title=Template:Mbox_templates/doc&action=edit view source]
* Template:Navbox [http://en.wikipedia.org/w/index.php?title=Template:Navbox&action=edit view source]
* Template:- [http://en.wikipedia.org/w/index.php?title=Template:-&action=edit view source]
* Template:· [http://en.wikipedia.org/w/index.php?title=Template:%C2%B7&action=edit view source]
* Template:Tnull [http://en.wikipedia.org/w/index.php?title=Template:Tnull&action=edit view source]
* Template:Shortcut [http://en.wikipedia.org/w/index.php?title=Template:Shortcut&action=edit view source]
* Template:High-risk [http://en.wikipedia.org/w/index.php?title=Template:High-risk&action=edit view source]
* Template:Main [http://en.wikipedia.org/w/index.php?title=Template:Main&action=edit view source]
* Template:Namespace detect [http://en.wikipedia.org/w/index.php?title=Template:Namespace_detect&action=edit view source]
* Template:Clr [http://en.wikipedia.org/w/index.php?title=Template:Clr&action=edit view source]

Extra templates that may help if you have problems
* Template:Cleanup [http://en.wikipedia.org/w/index.php?title=Template:Cleanup&action=edit view source]
* Template:Ambox [http://en.wikipedia.org/w/index.php?title=Template:Ambox&action=edit view source]
* Template:Ambox/core [http://en.wikipedia.org/w/index.php?title=Template:Ambox/core&action=edit view source]

4) I added the following for the album layout:
* Template:Infobox album [http://en.wikipedia.org/w/index.php?title=Template:Infobox_album&action=edit view source]
* Template:Infobox album/link [http://en.wikipedia.org/w/index.php?title=Template:Infobox_album/link&action=edit view source]
* Template:Infobox album/color [http://en.wikipedia.org/w/index.php?title=Template:Infobox_album/color&action=edit view source]
* Template:Extra album cover [http://en.wikipedia.org/w/index.php?title=Template:Extra_album_cover&action=edit view source]
* Template:Min [http://en.wikipedia.org/w/index.php?title=Template:Min&action=edit view source]
* Template:Rating [http://en.wikipedia.org/w/index.php?title=Template:Rating&action=edit view source] (Note: You will have to modify the file names for the stars once you upload them.)
* Template:Singles [http://en.wikipedia.org/w/index.php?title=Template:Singles&action=edit view source]
* Template:Loop15 [http://en.wikipedia.org/w/index.php?title=Template:Loop15&action=edit view source]
* Template:Navbox Musical artist [http://en.wikipedia.org/w/index.php?title=Template:Navbox_Musical_artist&action=edit view source]
* Template:Navbox Musical artist/color [http://en.wikipedia.org/w/index.php?title=Template:Navbox_Musical_artist/color&action=edit view source]
* Template:Navbox Musical artist [http://en.wikipedia.org/w/index.php?title=Template:Navbox_Musical_artist&action=edit view source]
* Template:Documentation/core2 [http://en.wikipedia.org/w/index.php?title=Template:Documentation/core2&action=edit view source]
* Template:Template other [http://en.wikipedia.org/w/index.php?title=Template:Template_other&action=edit view source]
* Template:Documentation/core/doc [http://en.wikipedia.org/w/index.php?title=Template:Documentation/core/doc&action=edit view source]
* Template:Fmbox [http://en.wikipedia.org/w/index.php?title=Template:Fmbox&action=edit view source]
* Template:Template doc [http://en.wikipedia.org/w/index.php?title=Template:Documentation&action=edit view source]

NOTE: In the <tt>Template:Infobox album</tt> code, I needed to replace the <tt><span /></tt> tag with <tt><span></span></tt> because the former was not being parsed correctly for some reason.

5) Test it all by creating a new page and posting the following code to it:
<pre>{{Infobox
|title = ETCwiki.org Infobox
|image = [[Image:example.png|200px]]
|header1 = Main Heading
|header2 = First set of data
|label2 = Label
|data2 = Data
|header3 = Remove this line (optional)
|label3 = More Label
|data3 = More data
}}
</pre>

==Miscellaneous Items==
===Redirect The Home Page===
The home page of this wiki was changed to point to the [[Welcome]] page by editing the [[MediaWiki:Mainpage]] page.

Wiki Build Notes - Revision history

0degreesk: Created page with "These are the steps that I took to customize this installation of [http://www.mediawiki.org/wiki/MediaWiki MediaWiki] (v. 1.15.2 – 2010-03-08) on the [http://www.hostmonster..."