<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>opengraph</title>
<meta name="viewport" content="width=device-width, initial-scale=1" />
<link rel="stylesheet" href="../../style.css" type="text/css" />
<link rel="stylesheet" href="../../local.css" type="text/css" />
</head>
<body>
<div class="page">
<div class="pageheader">
<div class="header">
<span>
<span class="parentlinks">
<a href="../../index.html">ikiwiki</a>/
<a href="../../plugins.html">plugins</a>/
<a href="../contrib.html">contrib</a>/
</span>
<span class="title">
opengraph
</span>
</span>
</div>
</div>
<div id="pagebody">
<div id="content" role="main">
<h1><a name="index1h1"></a>TL;DR</h1>
<p><strong>Plugin</strong>: <a href="https://notabug.org/hiatobr/ikiwiki-plugin-opengraph/raw/master/opengraph.pm">opengraph.pm</a></p>
<p><strong>Source</strong>: <a href="https://notabug.org/hiatobr/ikiwiki-plugin-opengraph">git</a></p>
<hr />
<div class="toc">
<ol>
<li class="L1"><a href="#index1h1">TL;DR</a>
</li>
<li class="L1"><a href="#index2h1">NAME</a>
</li>
<li class="L1"><a href="#index3h1">DESCRIPTION</a>
</li>
<li class="L1"><a href="#index4h1">DISCLAIMER</a>
</li>
<li class="L1"><a href="#index5h1">INSTALLATION</a>
</li>
<li class="L1"><a href="#index6h1">CONFIGURATION</a>
</li>
<li class="L1"><a href="#index7h1">TEMPLATES</a>
</li>
<li class="L1"><a href="#index8h1">BUGS AND LIMITATIONS</a>
</li>
<li class="L1"><a href="#index9h1">LICENSE AND COPYRIGHT</a>
</li>
<li class="L1"><a href="#index10h1">SEE ALSO</a>
</li>
</ol>
</div>
<hr />
<h1><a name="index2h1"></a>NAME</h1>
<p>IkiWiki::Plugin::opengraph - Adds Open Graph tags on the html head</p>
<hr />
<h1><a name="index3h1"></a>DESCRIPTION</h1>
<p>This plugin implements the Open Graph tags in the head of the hmtl for all pages, provided you configure it properly and add it to the current template.
For more information on what is Open Graph, visit <a href="https://en.wikipedia.org/wiki/Open%5FGraph">Open Graph</a>.
To test your site against the Open Graph rules, use the tool available on <a href="https://developers.facebook.com/tools/debug/og/object/">https://developers.facebook.com/tools/debug/og/object/</a>.</p>
<h1><a name="index4h1"></a>DISCLAIMER</h1>
<blockquote>
<p><strong>WARNING: Open Graph is modern spyware. You should use this if and only if you don't mind making the readers of your wiki/blog being tracked by evil corporations without their consent. By using this plugin you are being mean to the people who are reading your content. You have been warned.</strong></p>
</blockquote>
<hr />
<h1><a name="index5h1"></a>INSTALLATION</h1>
<p>Put <a href="https://notabug.org/hiatobr/ikiwiki-plugin-opengraph/raw/master/opengraph.pm">opengraph.pm</a> in <em>${HOME}/.ikiwiki/IkiWiki/Plugin/</em> or elsewhere in
your <em>@INC</em> path. Or read <a href="../install.html">install</a>.</p>
<hr />
<h1><a name="index6h1"></a>CONFIGURATION</h1>
<p>Add to the configuration in your <a href="../../setup.html#index5h2">blog.setup</a> file.</p>
<pre><code>## Open Graph plugin
# For more information, see
# <https://en.wikipedia.org/wiki/Open_Graph#Open_Graph_protocol>.
# Default values for <http://ikiwiki.info>
# obtained from <https://developers.facebook.com/tools/debug/og/object/>
# meta property="og:title"
opengraph_title: "ikiwiki"
# meta property="og:type"
opengraph_type: "website"
# meta property="og:url"
opengraph_url: "http://ikiwiki.info/"
# meta property="og:image"
opengraph_image: "http://ikiwiki.info/logo/ikiwiki.png"
# meta property="og:description"
opengraph_description: "Ikiwiki is a wiki compiler."
</code></pre>
<p>Add <em>opengraph</em> to the list of plugins:</p>
<pre><code>add_plugins: [qw{goodstuff opengraph}]
</code></pre>
<hr />
<h1><a name="index7h1"></a>TEMPLATES</h1>
<p>You will need to add the following code to <a href="../../templates.html">page.tmpl</a> on the current
<a href="../../templates.html">template</a>. It <strong>must</strong> be in the section of the . I recommend
puting it after the tag.</p>
<pre><code><TMPL_IF OPENGRAPH>
<TMPL_VAR OPENGRAPH_TAGS>
</TMPL_IF>
</code></pre>
<hr />
<h1><a name="index8h1"></a>BUGS AND LIMITATIONS</h1>
<p>...that's not a bug. It's an issue. Issues shall be reported <a href="https://notabug.org/hiatobr/ikiwiki-plugin-opengraph/issues">here</a></p>
<p>Seriously, I don't know how to fetch the current page's description. Help on that is appreciated.</p>
<hr />
<h1><a name="index9h1"></a>LICENSE AND COPYRIGHT</h1>
<p>Copyleft (.) 2015 Hacklab Independência</p>
<p>This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.</p>
<p>This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.</p>
<p>You should have received a copy of the GNU General Public License
along with this program. If not, see <a href="http://www.gnu.org/licenses/">http://www.gnu.org/licenses/</a>.</p>
<hr />
<h1><a name="index10h1"></a>SEE ALSO</h1>
<p><a href="../../index.html">Ikiwiki</a></p>
<p><a href="https://en.wikipedia.org/wiki/Open%5FGraph">Open Graph</a></p>
<p><a href="https://ikiwiki.info/plugins/contrib/opengraph">https://ikiwiki.info/plugins/contrib/opengraph</a></p>
</div>
</div>
<div id="footer" class="pagefooter" role="contentinfo">
<div id="pageinfo">
<div id="backlinks">
Links:
<a href="../../tips/bootstrap_themes_evaluation.html">tips/bootstrap themes evaluation</a>
</div>
<div class="pagedate">
Last edited <span class="date">Tue Feb 26 23:01:54 2019</span>
<!-- Created <span class="date">Tue Feb 26 23:01:54 2019</span> -->
</div>
</div>
<!-- from ikiwiki -->
</div>
</div>
</body>
</html>
