Test plan

The Test plan will document generic tests that should be run against Saintapedia after an upgrade. This page should not include any sensitive network or architecture elements.

User:Tom - Check this one out

Data

Ensure no data was lost by updating Saintapedia:Statistics just before backup and after the upgrade from Special:Statistics. Once done, the statistics should be compared.

• Pages (Articles)

• Jobs

• Registered Users

• Administrators

• Page Edits

• Active Users

• Files Uploaded

• Total Pages

• Page views

Installed extensions

This list was created from Special:Version in August 2024.

CiteThisPage

• Description - Adds a Special:CiteThisPage citation special page and toolbox link

• Test - https://openusaproject.com/w/index.php?title=Special:CiteThisPage&page=File+sharing

Contribution Scores

• Description - Contribution scores polls the wiki database for highest Special:ContributionScores user contribution volume

• Test - See if the top 10 contributors since the beginning of wiki are displayed below.

All time (Top 10)

Rank Score Pages Changes Username 1 7,364 7,200 13,917 MrT (talk | contribs) 2 1,183 1,136 1,689 OpenBook (talk | contribs) 3 118 96 220 Star (talk | contribs) 4 2 2 2 RP1 (talk | contribs) 5 1 1 1 MediaWiki default (talk | contribs)

Echo

• Description - System for notifying users about events and messages
• Test - With another account, see if you can:
  • Use the Thanks tool
  • Mention someone using the {{@}} template on a talk page
  • Undo a change

Interwiki

• Description - Extension:Interwiki  adds a Special:Interwiki special page to view and edit the interwiki table
• Test - Test if openei:Gateway:Hydrogen works

Renameuser

• Description - Adds a Special:RenameUser special page to rename a user (need renameuser right)

• Test - Using an account with the correct rights, rename a user account (check Special:Log/renameuser afterwards)

Replace Text

• Extension:Replace Text  provides a special page to allow administrators to do a global string find-and-replace on all the content pages of a wiki

• Test - Use Special:ReplaceText to make a text replacement

UserMerge

• Description - Special:UserMerge Merges references from one user to another user in the wiki database - will also delete old users following merge. Requires usermerge privileges

• Test - After other testing is done with test account, attempt to merge it into a primary account

VisualEditor

Main article: Visual editor

• Description - Visual editor for MediaWiki. See also Saintapedia:Test_plan#Visual_editor below.
• Test 1 - Using Help:Visual editor, verify that all menu items work, including:
  • Undo and redo
  • Headings
  • Full list of Formatting
  • Linking tool
  • Cite menu
  • Lists and indentation
  • Insert
  • Special character insertion
  • Page options
  • Switch to old editor
• Test 2 - Ensure that Help:Visual editor is an option on the following namespaces and all functions work.

Namespace	Example	Talk page	Example
Main	Saintapedia	Talk	Talk:Saintapedia
User	User:Tom	User talk	User talk:Tom
Saintapedia	Saintapedia:Historic content	Saintapedia talk	Saintapedia talk:Red link
File	TBD	File talk	TBD
MediaWiki	Not enabled	MediaWiki talk	MediaWiki talk:Anonnotice
Template	No enabled	Template talk	Template talk:Video table
Help	Help:Images	Help talk	Help talk:Files
Category	Category:E-mails	Category talk	Category talk:Biography
Portal	Portal:Secretarial Memoranda	Portal talk	Portal talk:Chemical element
Module	No enabled	Module talk	Module talk:Bananas

WikiEditor

• Description - Provides an extendable wikitext editing interface and many feature-providing modules
• Test - Test all features of Enhanced editor's toolbar

CategoryTree

• Description - Category tree dynamically navigate the Special:CategoryTree category structure
• Test - See if the Category tree appears below.

Images

Portal:Help/Tips

Portal:Help/Tips/4

Cite

• Description - Adds <ref[ name=id]> and <references/> tags, for citations
• Test - Ensure that the reference is working

DynamicPageList

• Description - Dynamic Page List outputs a bulleted list of the most recent items residing in a category, or an intersection of several categories

• Test - Check if the list of Saintapedia Ambassadors appears below (limited to 15 people).

<DynamicPageList>

 category=Saintapedia Ambassadors

 ordermethod=sortkey

 order=ascending

 count=15

</DynamicPageList>

EmbedVideo

• Description - Adds a parser function embedding video from popular sources.

• Test - See if the video is playable below.

{{#evt:service=youtube|id=https://www.youtube.com/watch?v=TdBAHexVYzc%7Calignment=left%7Cdimensions=400%7Cdescription=We Can Now Edit Our DNA. But Let's Do it Wisely - Co-inventor Jennifer Doudna - TED Talks}}

ImageMap

• Description - Image Map allows client-side clickable image maps using <imagemap>tag

• Test - Confirm that you clicking on portions of the map below will take you to the appropriate state.

Map of United States. Each state is a clickable link.
AL - AK - AS - AZ - AR - CA - CO - CT - DE - DC - FL - GA - GU - HI - ID - IL - IN - IA - KS - KY - LA - ME - MD - MA - MI - MN - MS - MO - MT - NE - NV - NH - NJ - NM - NY - NC - ND - NMI - OH - OK - OR - PA - PR - RI - SC - SD - TN - TX - UT - VT - VI - VA - WA - Washington, D.C. - WV - WI - WY

Maps

• Description - Maps enables embedding of dynamic maps into wiki pages, geocoding of addresses and other geographical operations

• Test - See if the Forrestal traffic map appears below.

ParserFunctions

• Description - Enhance parser with logical functions
• Test - Ensure parser functions are working
  • Examples
    • The number of calendar days between 1 December 2010 and today is: 2949
    • Additional Examples are shown below using Labeled Section Transclusion, provided it is working.
• {{#time: F j, Y}} will show the current date: January 23, 2025. Other common formats for displaying a date include:
  • {{#time: n/j/y}}: 1/23/25,
  • {{#time: m/d/Y}}: 01/23/2025 (with zero padding added, if necessary, to make the month and day each 2 digits long, and a 4-digit year), and
  • {{#time: Y-m-d}}: 2025-01-23.
  • {{#time: Y F d H:i:s}}: 2025 January 23 04:11:28
  • {{#timel: Y F d H:i:s}}: 2025 January 22 23:11:28
  • {{#ifexpr: 1 > 0 | yes | no }} can compare values: yes
  • {{#ifeq: {{#time: D}} | Fri | TGIF!}} will display a message only on Fridays: 
  • {{#switch: {{#time: D}} | Fri=TGIF! | Sat=Weekend | Sun=Weekend | #default=Where's my coffee?}} will display a different message on different days: Where's my coffee?

PdfBook

• Description - pdfbook-desc

• Test

• • "Download page as PDF " is in left navigation (Toolbox)

• • Ensure PDF Export functionality is working

RSS feed

• Description - Displays RSS feeds on MediaWiki pages in a standard or in user-definable formats using template pages

• Test - Ensure the RSS feed below works

<rss max="3" template="RSSPost">https://www.energy.gov/rss/energygov/2193718</rss>

Scribunto

• Description - Framework for embedding scripting languages into MediaWiki pages
• Test
  • "Hello, world!" should appear in the bullet below using {{#invoke:Bananas|hello}}
    • Hello, world!
  • Alternatively add {{#invoke:Bananas|hello}} to your Sandbox using Enhanced editor. If it says "Hello, world!" when you save it, Scribunto is working.

SyntaxHighlight

• Description - Provides syntax highlighting <syntaxhighlight> using Pygments - Python syntax highlighter

• Test - The wikitext below should be color coded when saved.

Wikitext:

<syntaxhighlight lang="php">
<?php
    $v = "string";    // sample initialization
?>
html text
<?
    echo $v;         // end of php code
?>
</syntaxhighlight>

Saved wikitext:

<?php
    $v = "string";    // sample initialization
?>
html text
<?
    echo $v;         // end of php code
?>

TemplateData

• Description - Implement data storage for template parameters (using JSON)
• Test - When adding or editing a template, that has TemplateData created, it should allow you to make changes using a form.
  • Example - John.Bosco

TemplateStyles

• Description - The TemplateStyles  extension introduces a tag to specify that a stylesheet should be loaded from a wiki page. Placing this in a template allows the template to have custom styles without having to place them in MediaWiki:Common.css. For instructions on how to use the extension as an editor on a wiki, see Help:TemplateStyles.

• Test - Review Help:TemplateStyles/examples

Hit Counter

• Description - Provides per page view statistics

• Test - At the bottom of each page there should be a statement "This page has been accessed x times," such as at the bottom of Portal:Welcome to Saintapedia.

• • Bonus test - Is it updated daily (for more viewed pages)

PDF Handler

• Description - Handler for viewing PDF files in image mode.

• Test - Ensure that appears as an image below.

AdvancedSearch

• Description - AdvancedSearch  enhances Special:Search by providing an advanced parameters form and improving how namespaces for a search query are selected.

• Test - Go to Special:Search and ensure the form can be used to filter results appropriately

CategoryTagSorter

• Description - The CategoryTagSorter  extension alphabetizes category links at the bottom of an article.

• Test -
  • Go to Test page
  • If they are not there, add two categories in this order:
  • [[Category:XYZ test category]]
  • [[Category:ABC test category]]
  • View the bottom of the page to see if Category:ABC test category is before Category:XYZ test category. Please note, their location on the page, if viewed using Edit source, will not be changed.

CirrusSearch

• Description - The CirrusSearch  extension implements searching for MediaWiki using Elasticsearch.
• Test - As this affects the default search for the wiki, test one or two of the features mentioned on Help:Search:
  • sorting navigation suggestions by the number of incoming links.
  • Starting with the tilde character ~ to disable navigation and suggestions in such a way that also preserves page ranking.
  • Smart-matching characters by normalizing (or "folding") non-keyboard characters into keyboard characters.
  • Words and phrases that match are highlighted in bold on the search results page.
  • Ability to search within PDFs with machine readable text (non-image PDFs)
  • Fuzzy searches and wildcard searches will be improved (Words, phrases, and modifiers)
  • Some spelling correction using the "Did you mean?"
    • Example - When searching for "secratary," it gives the searcher "Showing results for secretary. Search instead for secratary."
  • Ability to look for pages in specific categories (incategory), have a template (hastemplate), or pages that link to a page (Linksto)
    • Examples - incategory: AU, hastemplate: Cats, linksto: "Correspondence reference materials (Office of Science)"
  • When you start typing in the search box, the article suggestions are sort by article quality. Those suggestions should take into account the number of incoming wikilinks, the size of the page, the number of external links, the number of headings, and the number of redirects.
  • Look for similar pages (Morelike), have text in the page title (intitle), or search subpages (recommended mainly for Portals)
    • Examples - morelike:Electric vehicle, morelike:Electric vehicle|Office of Energy Efficiency and Renewable Energy, subpageof:"Training (Saintapedia)", and portal:subpageof:"2016 Transition"
  • Search the uploaded files by size (filesize), type (filetype), file format (filemime), or other measurements (File measures )
    • Examples - filesize:<10240, filetype:video, filemime:svg, and filewidth:1024
  • Expanding templates, meaning that all content from a template is now reflected in search results.
  • Faster updates to the search index, meaning changes to articles are reflected in search results much faster.

DismissableSiteNotice

• Description - Allows users to close the sitenotice
• Test - Using an account with the rights,
  • add a Help:Sitenotice 
  • See if it can be dismissed

Elastica

• Description - The Elastica  extension provides base elasticsearch functionality. Further information is available on the CirrusSearch extension's page.

• Test - See #CirrusSearch above.

Google Analytics Integration

• Description - Inserts Google Universal Analytics (and/or other web analytics) scripts into MediaWiki pages for tracking

• Test - Login to Google Analytics and check if data is being fed to it from Saintapedia

MobileFrontend

File:Switch to mobile view.png

Switch to mobile front end

• Description - Mobile Front end creates a separate mobile site for your mobile traffic and provides various content transformations to make your content more friendly

• Test

• • On a desktop, go to the bottom of any Saintapedia page

• • See if there is a link to "Mobile view"

• • Ensure the display changes appropriately

MultiBoilerplate

• File:MultiBoilerplate example.png

  Drop down list
  Description - Allows a boilerplate template to be selected from a drop down box located above the edit form when editing pages

• Test

• • Follow a red link

• • See if the drop down menu is given as an option

MultimediaViewer

• Description - The MultimediaViewer  extension gives the user of a wiki a different interface for viewing full-size, or nearly full-size, images in their browser without extraneous page loads or confusing interstitial pages.

• Test - Click on a page with a large image. Examples:

• • Help:Editing Saintapedia#Editing sections - Help:Editing Saintapedia#/media/File:Enhanced editor advanced tab.png

• • Help:Maps#Map editor - Help:Maps#/media/File:Map Editor Screenshot.png

• • Help:Watchlist - Help:Watchlist#/media/File:Watchlist star - Adding a page.png

• • Help:Editors - Help:Editors#/media/File:MediaWiki editors.png

NewUserMessage

• Extension:NewUserMessage 

• Test - Check Special:Contributions/WelcomingCommittee to see if new editors are being welcomed.

PageNotice

• Description - PageNotice lets you define a fixed header or footer message for each namespace or individual page

• Test - Check if all talk pages, such as Talk:Suspect or Counterfeit Items and Defective Items, shows the contents of MediaWiki:Top-notice-ns-1

ParserHooks

• Description - ParserHooks  adds an object orientated and declarative parser hook interface on top of MediaWiki.

• Test - Testing should be done above in ParserFunctions.

PrivateWiki

• Description - PrivateWiki attempts to close obvious security holes for private Wikis. This includes disabling remember-password features on both client and server sides, not leaking valid user names at login and recording failed login attempts (for use with fail2ban or similar tools).

• Test - Check if "Keep me logged in" option is removed from the login page (see Security enhancements for more details).

RedirectAfterLogout

• Description - RedirectAfterLogout  redirect to a certain page after logout.

• Test - Exploring if still needed

SandboxLink

• Extension:SandboxLink  extension adds a link to user's personal sandbox to personal tools menu. The sandbox is assumed to exist, or will be created, at a "/sandbox" subpage of user's userpage.

• Test - When logged in, is the a link to your Sandbox in the upper right hand corner of every page?

Thanks

• 

  Thanks tool
  Description - The Thanks tool enables editors to send a 'Thank you' notification to users who make constructive edits, to give them positive feedback.

• Test - Look at a page's article history page or Difference view to ensure there is a "Thank" link. if so, follow the Thanks Process.

TitleKey

• Description - Title prefix search suggestion backend

• Test - Search for "Ocio" and see if it is changed to "OCIO"

Validator

• Description - The Validator MediaWiki extension, provides a parameter processing framework that provides a way to declaratively define a set of parameters and how they should be processed. It can take such declarations together with a list of raw parameters and provide the processed values.

• Test - Testing done by Admins

Basics

• The login page shows MediaWiki:Loginprompt

• The post login page should have the items below, which is configured in the LocalSettings file

• • You are now logged in to Saintapedia as "Username".

• • The list of what not to post from What not to post on Saintapedia

• Compare the list of extension on Special:Version before the upgrade and confirm that they are there after the upgrade (This page's inventory of extensions could also be helpful)

• Ensure edits can be made using both in Visual editor and using the Enhanced editor

• Check that you are able to

• • Undo a change,

• • rename a page

• • Create a redirect

• • Change your preferences

• • Access Saintapedia on a mobile device and that it is using the Mobile Front End

• • Create an account

• • Reset password

• Ensure you cannot change your password to your personal email address (only accept allowed domains can create a Saintapedia account)

• Check if HTTPs (SSL) is enabled

• Ensure Saintapedia:bots are working

• For Watchlists, check if:

• • it is possible to add/remove a page to your watchlist

• • Email notifications work

• Ensure the default main page is Portal:Welcome to Saintapedia, not the generic "Mainpage" by clicking the logo. The function is set at MediaWiki:Mainpage

Look and feel

File:MediaWiki116 new and old watch tab.png

Watch star

Verify that MediaWiki:Common.css and MediaWiki:Common.js are functioning correctly.

• If the two complex template structures: {{Navbox}} and {{Infobox}} are working, then that is a good sign that common.css and common.js are correct. Both template pages have examples on them that can easily show whether the various components are working. Note that as of 2019, all Navboxes are auto collapsed by the JavaScript

• Test, on various browsers, that unauthenticated (not logged-in) readers are shown the Vector theme by default.

• Ensure the "star" function for Watchlist is available on the skin (when logged in). See the Watch star graphic to the right.

• Check look and feel in all browsers

• The Editing Toolbar, in Enhanced editor, should:

• • Expand correctly

• • There should not be any overlap of the buttons

• • There should be no shadow on the icons

Uploading documents

Main page: Help:Files

• Upload a document up to 15 MB (as of Jan 2019)

• • Using Special:Upload for non-image files

• • Add images using the Image upload wizard available through VisualEditor and Enhanced editor

• Verify the types of files that can be uploaded

• • On Special:Upload, in January 2019, the list includes png, gif, jpg, jpeg, svg, doc, docx, dot, dotx, pps, ppsx, ppt, pptx, xls, xlsx, pdf, mp4, txt, flac, mkv, mov, mp3, oga, ogg, ogv, wav, webm

• • Contact Tom O'Neill if you would like a copy of the upload test files (currently restricted to by invite by invite only to EITS supported customer)

• • Note - Some original format office documents [.doc, .xls, etc.] cannot be uploaded due to a S/MIME error. They should be able to be opened if they are already in Saintapedia. An easy work around is to convert the file to the newer file format (docx, pptx, xlsx, etc.).

Multimedia appearance

Check to ensure that certain multimedia files are being displayed correctly

Images

• Check that image galleries are displaying correctly and editable using VisualEditor

• Verify that all file types that appear as images are working

• Cor acq ls2.png

  PNG

• China-pie chart2.gif

  GIF

• Certification Letter.JPG

  JPG

• SAFE Screenshot (1).jpeg

  JPEG

• Crystal Clear action exit.svg

  SVG

• A Guide for Administrative Coordinator and Editor.pdf

  PDF

Videos

MP4	OGV
File:DAYS to Fuji WebEx Demo.mp4	File:Edit Button.ogv

Music

MP3	OGA	FLAC
File:Mozart Symphony 36 KV 425 Linz 3.oga.mp3	File:Mozart Symphony 36 KV 425 Linz 3.oga	File:En-uk-cooling glasses.flac

Bots

Make sure the Saintapedia:Bots are still working after the upgrade. Suggest manually running one or more of the existing bot scripts from the bot server to ensure things still operate as expected. See the bots running below.

• Top editors

• Statistics

• Double redirect

• New accounts

• Duplicate files

• Adding categories by files and by name

Portals

• Do portals display correctly?

• • Test Portal:Welcome to Saintapedia and Portal:Occupational medicine

• Are they hiding their Table of contents?

• Do the edit links work to the subpages?

Security

• Is remember password disabled on Special:UserLogin?

Other

• High resolution images may give "Error creating thumbnail: Invalid thumbnail parameters." This error can be resolved by reducing the image resolution.

• 508 Compliance, accessibility to disabled persons... ?

• Readability testing to establish the audience education level appropriate to the complexity of the content -> plain language compliance?