Extension:WikiSEO

MediaWiki 拡張機能マニュアル

WikiSEO リリースの状態: 安定
実装	パーサー関数
説明	Allows to add common meta elements as part of Search Engine Optimisation (SEO)
作者	Octfxトーク
メンテナー	Octfx
最新バージョン	2.7.0 (2023-06-29)
MediaWiki	1.39+
PHP	7.4+
Composer	octfx/wiki-seo
ライセンス	GNU 一般公衆利用許諾書 2.0 以降
ダウンロード	拡張機能をダウンロード Git [?]: Git master をダウンロード リポジトリを参照 (Phabricator · GitHub) コミット履歴 リポジトリの貢献者 (GitHub) コード レビュー
パラメーター $wgWikiSeoSocialImageShowAuthor $wgFacebookAdmins $wgWikiSeoSocialImageShowLogo $wgPinterestSiteVerificationKey $wgMetadataGenerators $wgGoogleSiteVerificationKey $wgFacebookAppId $wgWikiSeoSocialImageHeight $wgBingSiteVerificationKey $wgTwitterCardType $wgYandexSiteVerificationKey $wgWikiSeoEnableSocialImages $wgWikiSeoTryCleanAutoDescription $wgWikiSeoDefaultImage $wgNortonSiteVerificationKey $wgTwitterSiteHandle $wgWikiSeoSocialImageBackgroundColor $wgWikiSeoDefaultLanguage $wgWikiSeoSocialImageWidth $wgWikiSeoOverwritePageImage $wgNaverSiteVerificationKey $wgWikiSeoSocialImageIcon $wgWikiSeoEnableAutoDescription $wgWikiSeoDisableLogoFallbackImage $wgWikiSeoNoindexPageTitles $wgWikiSeoSocialImageTextColor
使用するフック BeforePageDisplay InfoAction OutputPageAfterGetHeadLinksArray ParserFirstCallInit RevisionDataUpdates ScribuntoExternalLibraries
提供するフック WikiSEOPreAddMetadata WikiSEOPreAddPageProps WikiSEOLuaPreAddPageProps
四半期ごとのダウンロード数	123 (Ranked 48th)
translatewiki.net で翻訳を利用できる場合は、WikiSEO 拡張機能の翻訳にご協力ください
問題点	未解決のタスク · バグを報告

The WikiSEO extension allows you to replace, append or prepend the HTML title tag content. It also allows you to add common SEO (Search Engine Optimisation) meta elements such as "keywords" and "description".

A working job queue is absolutely required for this extension to function.

インストール

• ダウンロードして、ファイルをextensions/フォルダー内のWikiSEOという名前のディレクトリ内に配置します。
  開発者とコード寄稿者は、上記の代わりに以下を使用してGitからインストールします:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/WikiSEO
• 以下のコードを LocalSettings.php ファイルの末尾に追加します:

  wfLoadExtension( 'WikiSEO' );
  

• 必要に応じて設定します。
•  完了 – ウィキの「Special:Version」に移動して、拡張機能が正しくインストールされたことを確認します。

使用法

The extension can be used via the {{#seo}} parser function or in Lua modules by using mw.ext.seo.set(). It accepts the following named parameters in any order.

Parameters supported by all generators

名前	既定	説明	例
title	(empty)	The title you want to appear in the html title tag. Will also be used for OpenGraph, Schema.org and Twitter metadata.	{{#seo:|title=This is the title of the page}}
title_mode	replace	Set to append, prepend, or replace (default) to define how the title will be amended. Further examples can be found here.	{{#seo:|title=This replaces the Title of the Page|title_mode=replace}}
title_separator	-	The separator in case title_mode was set to append or prepend.	{{#seo:|title=This gets prepended to the page name separated by the separator|title_mode=prepend|title_separator=<<}}
keywords	(empty)	A comma separated list of keywords describing the page content. Will also be used for OpenGraph, Schema.org and Twitter metadata.	{{#seo:|keywords=Apple, Pears, Oranges}}
description	(empty)	A short text describing the page topic. Will also be used for OpenGraph, Schema.org and Twitter metadata.	{{#seo:|description=This page contains information about...}}

Parameters supported by Metatag generator

名前	既定	説明	例
robots	(empty)	Controls the behaviour of search engine crawling and indexing	{{#seo:|robots=noindex, nofollow}}
googlebot	(empty)	Controls the behaviour of the google crawler	{{#seo:|googlebot=noindex, nofollow}}
hreflang_xx-xx	(empty)	Adds <link rel="alternate" href="url" hreflang="xx-xx"> elements	{{#seo:|hreflang_de-de=https://example.com}}

Parameters supported by OpenGraph / Twitter generator

Name	Default	Description	Example
type	(empty)	The type of your object, e.g., "video.movie". Depending on the type you specify, other properties may also be required.	{{#seo:|type=website}}
image	(empty)	An image URL which should represent your object within the graph. The extension will automatically add the right image url, width and height if an image name is set as the parameter. Example image = Local_file_to_use.png. Alternatively a full url to an image can be used, image_width and image_height will then have to be set manually. If no parameter is set, the extension will use $wgLogo as a fallback or the local file set through $wgWikiSeoDefaultImage.	{{#seo:|image=Local_File.png}}
image_width	(empty)	The image width in px. (Automatically set if an image name is set in image)	{{#seo:|image_width=420}}
image_height	(empty)	The image height in px. (Automatically set if an image name is set in image)	{{#seo:|image_height=69}}
image_alt	(empty)	A short sentence describing the image	{{#seo:|image_alt=A picture showing an orange cat.}}
locale	(empty)	The locale these tags are marked up in. Of the format language_TERRITORY.	{{#seo:|locale=en-US}}
site_name	(empty)	If your object is part of a larger web site, the name which should be displayed for the overall site. e.g., "IMDb".	{{#seo:|site_name=WMF}}

Parameters with type=article supported by OpenGraph generator

See type=article.

Name	Default	Description	Example
author	(empty)	Writers of the article.	{{#seo:|author=Jon Doe}}
section	(empty)	A high-level section name. E.g. Technology	{{#seo:|section=Technology}}
published_time	(empty)	When the article was first published. ISO 8601 Format.	{{#seo:|published_time=2012-01-25}}

Parameters supported by Twitter generator

See OpenGraph Tags.

Name	Default	Description	Example
twitter_site	(empty)	If you did not set a global site name through $wgTwitterSiteHandle, you can set a site handle per page. If a global site handle is set this key will be ignored.	{{#seo:|twitter_site=MediaWiki}}

Parameters supported by Citation generator

See Schema.org.

Name	Default	Description	Example
citation_type	ScholarlyArticle	Used in @graph @type	{{#seo:|citation_type=MedicalScholarlyArticle}}
citation_name	(empty)	Name of the Publication	{{#seo:|citation_name=Cataloging & Classification Quarterly}}
citation_headline	(empty)	Headline of the article.	{{#seo:|citation_headline=Works in Cataloging}}
citation_date_published	(empty)	Date of first broadcast/publication.	{{#seo:|citation_date_published=2012-01-01}}
citation_date_created	(empty)	The date on which the CreativeWork was created or the item was added to a DataFeed.	{{#seo:|citation_date_created=2012-01-01}}
citation_page_start	(empty)	The page on which the work starts; for example "135" or "xiii".	{{#seo:|citation_page_start=135}}
citation_doi	(empty)	URL of a reference Web page that unambiguously indicates the item's identity. E.g. the URL of the item's Wikipedia page, Wikidata entry, or official website.	{{#seo:|citation_doi=http://dx.doi.org/10.1038/nphys1170}}
citation_author	(empty)	One or more authors separated by ';'	{{#seo:|citation_author=Doe, John; Bar, Foo}}
citation_publisher	(empty)	Name of the publisher	{{#seo:|citation_journal_title=Elsevir}}
citation_license	(empty)	A license document that applies to this content, typically indicated by URL.	{{#seo:|citation_license=link}}
citation_volume	(empty)	Volume number	{{#seo:|citation_volume=50}}
keywords	(empty)	Article Keywords (*)	{{#seo:|citation_keywords=Keyword a; Keyword b; ...}}
description	(empty)	A description of the item (*)	{{#seo:|description=An article about cataloging}}

(*) these parameters are supported by all generators.

Do note that the Citation generator is not activated by default! To activate the generator add the following snippet to LocalSettings.php:

$wgMetadataGenerators[] = "Citation";

例

Adding static values

{{#seo:
|title=Your page title
|title_mode=append
|keywords=these,are,your,keywords
|description=Your meta description
|image=Uploaded_file.png
|image_alt=Wiki Logo
}}

Adding dynamic values

If you need to include variables or templates you should use the parser function to ensure they are properly parsed. This allows you to use Cargo or Semantic MediaWiki , with Page Forms , for data entry, or for programmatic creation of a page title from existing variables or content...

{{#seo:
 |title={{#if: {{{page_title|}}} | {{{page_title}}} | Welcome to WikiSEO}}
 |title_mode={{{title_mode|}}}
 |keywords={{{keywords|}}}
 |description={{{description|}}}
 |published_time={{REVISIONYEAR}}-{{REVISIONMONTH}}-{{REVISIONDAY2}}
}}

{{#seo:
 |title_mode=append
 |title=Example SEO Wiki
 |keywords=WikiSEO, SEO, MediaWiki
 |description=An example description for this wiki
 |image=Wiki_Logo.png
 |image_alt=Wiki Logo
 |site_name=Example SEO Wiki
 |locale=en_EN
 |type=website
 |modified_time={{REVISIONYEAR}}-{{REVISIONMONTH}}-{{REVISIONDAY2}}
 |published_time=2020-11-01
}}

Usage in Lua modules

-- Module:SEO
local seo = {}

--[[
argTable format:
{
  title_mode = 'append',
  title = 'Example Seo Wiki',
  keywords = 'WikiSEO, SEO, MediaWiki',
  -- ...
}
]]--
function seo.set( argTable )
  mw.ext.seo.set( argTable )
end

function seo.setStatic()
  mw.ext.seo.set{
    title_mode = 'append',
    title = 'Example Seo Wiki',
    keywords = 'WikiSEO, SEO, MediaWiki',  
  }
end

return seo

The module would now be callable as {{#invoke:SEO|set|title=ExampleTitle|keywords=WikiSEO, SEO, MediaWiki}} or {{#invoke:SEO|setStatic}}.

Hreflang Attributes

{{#seo:
 |hreflang_de-de=https://example.de/page
 |hreflang_nl-nl=https://example.nl/page-nl
 |hreflang_en-us=https://website.com/
}}

Will generate the following ‎<link> elements:

<link rel="alternate" href="https://example.de/page" hreflang="de-de">
<link rel="alternate" href="https://example.nl/page-nl" hreflang="nl-nl">
<link rel="alternate" href="https://website.com/" hreflang="en-us">

Title Modes

Example: Page with title Example Page

Append

{{#seo:
 |title_mode=append
 |title=Appended Title
}}

HTML Title result: Example Page - Appended Title

Prepend

{{#seo:
 |title_mode=prepend
 |title=Prepended Title
}}

HTML Title result: Prepended Title - Example Page

Prepend (changed separator)

{{#seo:
 |title_mode=prepend
 |title=Prepended Title
 |title_separator= >> 
}}

HTML Title result: Prepended Title >> Example Page

Replace (default)

{{#seo:
 |title_mode=replace
 |title=Replaced Title
}}

HTML Title result: Replaced Title

Maintenance Script

WikiSEO provides a maintenance script to generate descriptions for specified pages. This script requires Extension:TextExtracts to be installed and active. The script will only generate descriptions for pages that don't have a description property set in the page properties table.

You can force the generation using the --force flag, this will overwrite any description already present.

A list of namespace ids needs to be given in order for the script to work:

# Run only in main namespace
php maintenance/GenerateDescription.php 0

# Run only in main namespace and overwrite existing descriptions
php maintenance/GenerateDescription.php --force 0

# Run in namespace 1234, overwrite descriptions and remove dangling sentences
php maintenance/GenerateDescription.php --force --cleanSentence 1234

設定

The following variables are in use by this extension.

Site / App Keys

Variable	Description	Usage
$wgGoogleSiteVerificationKey	Setting this variable will add a <meta name="google-site-verification" content="CODE"> tag to every page.	$wgGoogleSiteVerificationKey = 'CODE';
$wgBingSiteVerificationKey	Setting this variable will add a <meta name="msvalidate.01" content="CODE"> tag to every page.	$wgBingSiteVerificationKey= 'CODE';
$wgFacebookAppID	Setting this variable will add a <meta property="fb:app_id" content="ID"> tag to every page.	$wgFacebookAppID= 'App_ID';
$wgFacebookAdmins	Setting this variable will add a <meta property="fb:admins" content="ID1,ID2,..."> tag to every page.	$wgFacebookAdmins= 'ID1,ID2,...';
$wgYandexSiteVerificationKey	Setting this variable will add a <meta name="yandex-verification" content="CODE"> tag to every page.	$wgYandexSiteVerificationKey= 'CODE';
$wgAlexaSiteVerificationKey	Setting this variable will add a <meta name="alexaVerifyID" content="CODE"> tag to every page.	$wgAlexaSiteVerificationKey= 'CODE';
$wgPinterestSiteVerificationKey	Setting this variable will add a <meta name="p:domain_verify" content="CODE"> tag to every page.	$wgPinterestSiteVerificationKey= 'CODE';
$wgNortonSiteVerificationKey	Setting this variable will add a <meta name="norton-safeweb-site-verification" content="CODE"> tag to every page.	$wgNortonSiteVerificationKey= 'CODE';
$wgNaverSiteVerificationKey	Setting this variable will add a <meta name="naver-site-verification" content="CODE"> tag to every page.	$wgNaverSiteVerificationKey = 'CODE';

$wgWikiSeoDefaultImage

Set a default image to use if no image is set on the site. If this variable is not set the site's logo will be used.

Usage: $wgWikiSeoDefaultImage= 'Localfile.jpg';

$wgMetadataGenerators

Array containing the metadata generator names to load.

Default: ["OpenGraph", "Twitter", "SchemaOrg"]

If you only want to change the page title and add 'description', 'keywords', 'robots' tags set $wgMetadataGenerators = [];

$wgWikiSeoDisableLogoFallbackImage

Disable setting $wgLogo as a fallback image if no image for a page was set.

$wgTwitterCardType

Defaults to `summary_large_image` for the twitter card type.

Usage: $wgTwitterCardType = 'summary';

$wgWikiSeoNoindexPageTitles

An array of page titles where a 'noindex' robot tag should be added. Usage: $wgWikiSeoNoindexPageTitles = [ 'Custom_Title', 'Main_Page' ];

$wgWikiSeoDefaultLanguage

A default language code with area to generate a <link rel="alternate" href="current Url" hreflang="xx-xx"> for.

Usage: $wgWikiSeoDefaultLanguage = 'de-de';

$wgWikiSeoEnableAutoDescription

If no description was given in the parser function, a short description from Extension:TextExtracts will be requested. A description will only be set, if the page is edited and saved. Alternatively the maintenance script GenerateDescription can be run from the extension folder.

$wgWikiSeoTryCleanAutoDescription

Tries to remove dangling sentences from the description provided by TextExtracts. This will remove the last sentence not ending in a '.', and will result in descriptions shorter than 160 characters.

Social Media Images

Variable	Description	Usage
$wgWikiSeoEnableSocialImages	Generate dedicated social media icons for pages	$wgWikiSeoEnableSocialImages = true;
$wgWikiSeoSocialImageIcon	The icon/watermark to add to the social media image. Use a local file name	$wgWikiSeoSocialImageIcon = LocalFile.jpg;
$wgWikiSeoSocialImageWidth	Width of the social media image	$wgWikiSeoSocialImageWidth = 1200;
$wgWikiSeoSocialImageHeight	Height of the social media image	$wgWikiSeoSocialImageHeight = 620;
$wgWikiSeoSocialImageTextColor	Color of the text on the social image	$wgWikiSeoSocialImageTextColor = '#fff';
$wgWikiSeoSocialImageShowAuthor	Show the author of the current page revision	$wgWikiSeoSocialImageShowAuthor = true;
$wgWikiSeoSocialImageShowLogo	Show the Wiki logo in the top right corner	$wgWikiSeoSocialImageShowLogo = true;
$wgWikiSeoSocialImageBackgroundColor	Default background color if no page image is found	$wgWikiSeoSocialImageBackgroundColor = '#ff00ff';

Migrating from v1.2.2 to to v2.x

Removed tags

• DC.date.created
• DC.date.issued
• google
• name
• og:title (automatically set)
• og:url (automatically set)
• twitter:card (automatically set)
• twitter:creator
• twitter:domain
• article:modified_time / og:updated_time (automatically set)

Removed aliases

• metakeywords / metak

use keywords instead

• metadescription / metad

use description instead

• titlemode / title mode

use title_mode instead

Changed argument names

• article:author -> author
• article:section -> section
• article:tag -> keywords
• article:published_time -> published_time
• og:image / twitter:image:src -> image
• og:image:width -> image_width
• og:image:height -> image_height
• og:locale -> locale
• og:site_name -> site_name
• og:title -> title
• og:type -> type
• twitter:description -> description

Known issues

Extension:PageImages will add an og:image tag if an image is found on the page. If another image was set using WikiSEO, both og:image will be added to the page.

Further information:

• https://phabricator.wikimedia.org/T300587
• https://github.com/octfx/wiki-seo/issues/32

Setting $wgPageImagesOpenGraph = false; disables PageImages setting any og:image* meta tags.

Additionally you can set $wgWikiSeoOverwritePageImage = true; to overwrite the image set by PageImages with the one specified by WikiSEO.

Further details

This extension is not a drop-in replacement for the previous version of this extension from tinymighty/wiki-seo.

If you only want to override the display title on pages (not append words to it), you might also look at the DISPLAYTITLE tag in combination with the Manual:$wgAllowDisplayTitle and Manual:$wgRestrictDisplayTitle settings.

Note that this extension stores relevant properties in the page_props table. Its parser hook persists previous properties when invoked since commit 78245b3 (released in v2.6.6). This enables administrators to set these properties manually with other tools like Extension:PageProperties . On the other hand removed parameters from parser function call will persist in the page. These outdated properties can be purged by temporarily removing the magic words or disabling the extension, then reparsing the page.

schema.org

The SchemaOrg generator will set a SearchAction property based on Special:Search.

The properties publisher and author will be set to Organization with the name set to the content of $wgSitename.

dateModified will be automatically set by fetching the latest revision timestamp. If no published_time is set, datePublished will be set to the latest revision timestamp.

OpenGraph

article:modified_time will be automatically set by fetching the latest revision timestamp. If no published_time is set, article:published_time will be set to the latest revision timestamp.

Integration

WikiSEO will use descriptions provided by Extension:Description2 .

Notes

関連項目

• Extension:Description2
• Extension:MetaMaster
• Extension:Semantic Meta Tags
• Extension:AdvancedMeta
• Extension:PageProperties