Difference between revisions of "MediaWiki/archive/customizing"

from HTYP, the free directory anyone can edit if they can prove to me that they're not a spambot
Jump to navigation Jump to search
m (Woozle moved page MediaWiki customization to MediaWiki/archive/customizing without leaving a redirect: kinda outdated)
(should probably have a template for non-config files which just redirects to the official MW code docs)
Line 5: Line 5:
 
* [http://www.mediawiki.org/wiki/Customization MediaWiki Customization] at mediawiki.org
 
* [http://www.mediawiki.org/wiki/Customization MediaWiki Customization] at mediawiki.org
 
==Articles==
 
==Articles==
* [[modifying MediaWiki menus]]
+
* [[/menus]]
* [[shortening MediaWiki URLs]]
+
* [[/URLs]]
* [[add a new navigation box to MediaWiki]]
+
* [[/new navbox]]
* [[modifying the MediaWiki searchbox]]
+
* [[/searchbox]]
* [[MediaWiki user-group security]]
+
 
* [[MediaWiki extensions]]: custom coding using MW's built-in extensibility
+
Related:
 +
* {{l/same|extensions}}: custom coding using MW's built-in extensibility
 +
* {{l/same|user-group security}}
 
==Managed Customization==
 
==Managed Customization==
 
MediaWiki will include the contents of [[mediawiki:Common.css]], if found, in the CSS code it uses for defining the appearance of its pages. (The initial character in "Common" does not seem to be case-sensitive, even if the site has the initial-caps flag turned off.)
 
MediaWiki will include the contents of [[mediawiki:Common.css]], if found, in the CSS code it uses for defining the appearance of its pages. (The initial character in "Common" does not seem to be case-sensitive, even if the site has the initial-caps flag turned off.)
Line 16: Line 18:
 
==Code Notes==
 
==Code Notes==
 
''(From [[User:Woozle|Woozle]] 20:59, 15 Jun 2005 (CDT). Eventually to be given their own section, I expect.)''
 
''(From [[User:Woozle|Woozle]] 20:59, 15 Jun 2005 (CDT). Eventually to be given their own section, I expect.)''
*Everything obviously starts with [[index.php (MediaWiki)|index.php]]
+
*Everything obviously starts with [[MediaWiki/files/index.php|index.php]].
*For the purpose of displaying a page (not saving changes or doing anything else), this calls $wgArticle->view(), in [[MediaWiki/code/Article.php|Article.php]] (line 699)
+
*For the purpose of displaying a page (not saving changes or doing anything else), this calls $wgArticle->view(), in [[MediaWiki/files/Article.php|Article.php]] (line 699)
 
*$wgArticle->view() appears to be able to provide a few other formats besides the regular view (including difference engine and displaying redirections as subtitles), but I'm ignoring that for now
 
*$wgArticle->view() appears to be able to provide a few other formats besides the regular view (including difference engine and displaying redirections as subtitles), but I'm ignoring that for now
 
*$wgOut seems to be the object which accumulates text to be output, via various methods:
 
*$wgOut seems to be the object which accumulates text to be output, via various methods:

Revision as of 23:29, 14 December 2017

Navigation

{{#lst:MediaWiki|navbar}}: customization

Links

Articles

Related:

Managed Customization

MediaWiki will include the contents of mediawiki:Common.css, if found, in the CSS code it uses for defining the appearance of its pages. (The initial character in "Common" does not seem to be case-sensitive, even if the site has the initial-caps flag turned off.)

Code Notes

(From Woozle 20:59, 15 Jun 2005 (CDT). Eventually to be given their own section, I expect.)

  • Everything obviously starts with index.php.
  • For the purpose of displaying a page (not saving changes or doing anything else), this calls $wgArticle->view(), in Article.php (line 699)
  • $wgArticle->view() appears to be able to provide a few other formats besides the regular view (including difference engine and displaying redirections as subtitles), but I'm ignoring that for now
  • $wgOut seems to be the object which accumulates text to be output, via various methods:
    • $wgOut->addWikiText(...)
    • $wgOut->addHTML(...)
    • $wgOut->addPrimaryWikiText() # Display content and save to parser cache
    • $wgOut->addWikiText() # Display content, don't attempt to save to parser cache
    • $wgOut->setPageTitle()
    • $wgOut->transformBuffer(); # Put link titles into the link cache
    • $wgOut->addMetaTags(); # Add link titles as META keywords
  • ...and then it does these two lines:
    • $this->viewUpdates(); (found at line 1926 -- doesn't do much)
    • wfProfileOut( $fname );
  • It's not clear whether the navbar has already been pulled in by the time we hit viewUpdates -- possibly transformBuffer does it? The comment makes it sound like that, but the name "transformBuffer" in that case is not very descriptive. The code in there should probably be examined.