SocialCards Plugin

Compatible with DokuWiki

2024-02-06 "Kaos" unknown
2023-04-04 "Jack Jackrum" yes
2022-07-31 "Igor" yes
2020-07-29 "Hogfather" yes

Adds social media cards and semantic data to your wiki pages

Last updated on: 2023-06-30
Provides: Action
Repository: Source

Tagged with facebook, google+, meta, opengraph, search, semantic, seo, social, twitter

By Mark C. Prins

Adds social media cards (Twitter cards) and OpenGraph metadata (used amongst others by Facebook and Google+) to your wiki pages.

Installation

Search and install the plugin using the Extension Manager. Refer to Plugins on how to install plugins manually.

After installation and configuration you need to validate your card with Twitter. Go to https://cards-dev.twitter.com/validator and paste in a URL from your Wiki. Once you have previewed the card, Twitter will white list your website and start serving Twitter Cards in tweets.

Previously Twitter required approval to use cards, however this is now only necessary for 'Player' Cards – those with videos/audio.

Configuration and Settings

In the config panel the Twitter name used for the site and optionally that of an author should be entered, also you will want to update the language and fall back image. Optionally you can enter a Facebook App ID.

Since OpenGraph is based on RDF you need/may want to add the namespaces to your template to keep your pages syntactically valid and semantically correct. This should be done for the pages: main.php, mediamanager.php and detail.php pages of your template.

For (x)html 4 templates add the following namespaces to the html tag:

xmlns:og="http://ogp.me/ns#" 
xmlns:fb="http://ogp.me/ns/fb#" 
xmlns:article="http://ogp.me/ns/article#" 
xmlns:place="http://ogp.me/ns/place#"

Which would then look something like:

<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="nl" lang="nl" xmlns:og="http://ogp.me/ns#" xmlns:fb="http://ogp.me/ns/fb#" xmlns:article="http://ogp.me/ns/article#" xmlns:place="http://ogp.me/ns/place#">

For (x)html 5 templates add the following namespace prefixes to the head tag:

prefix="og: http://ogp.me/ns# fb: http://ogp.me/ns/fb# 
article: http://ogp.me/ns/article# place: http://ogp.me/ns/place#"

Which would then look something like:

<head prefix="og: http://ogp.me/ns# fb: http://ogp.me/ns/fb# article: http://ogp.me/ns/article# place: http://ogp.me/ns/place#">

Development

Change Log

🤖 Rector and PHPCS fixes (#43) (2024-01-02 09:53)
Update maintenance.yml (2023-11-19 15:18)
🤖 Rector and PHPCS fixes (#41) (2023-11-08 21:50)
Update phpCS.yml (2023-11-08 17:05)
Update CI.yml (2023-11-08 17:05)
Create autoFix.yml (2023-11-08 17:04)
Bump actions/checkout from 3 to 4 (#40) (2023-09-10 22:57)
update issue template to current GH convention (2023-08-14 12:21)

Discussion

Can it support variables? Like setting of the image based on page name? — Antiokh 2025-04-03 05:05

Table of Contents