Update the plugin information

#22

.travis.yml

@@ -1,16 +1,13 @@
-
 language: php
 php:
+  - "7.3"
   - "7.2"
   - "7.1"
   - "7.0"
   - "5.6"
-  - "5.5"
-  - "5.4"
 env:
   - DOKUWIKI=master
   - DOKUWIKI=stable
-  - DOKUWIKI=old-stable
 before_install: wget https://raw.github.com/splitbrain/dokuwiki-travis/master/travis.sh
 install: sh travis.sh
-script: cd _test && phpunit --stderr --group plugin_semantic
+script: cd _test && ./phpunit.phar --stderr --group plugin_semantic

_test/general.test.php

@@ -6,13 +6,15 @@
  * @group plugin_semantic
  * @group plugins
  */
-class general_plugin_semantic_test extends DokuWikiTest {
+class general_plugin_semantic_test extends DokuWikiTest
+{
 
     /**
      * Simple test to make sure the plugin.info.txt is in correct format
      */
-    public function test_plugininfo() {
-        $file = __DIR__.'/../plugin.info.txt';
+    public function test_plugininfo()
+    {
+        $file = __DIR__ . '/../plugin.info.txt';
         $this->assertFileExists($file);
 
         $info = confToHash($file);
@@ -32,4 +34,3 @@ class general_plugin_semantic_test extends DokuWikiTest {
         $this->assertTrue(false !== strtotime($info['date']));
     }
 }
-

action.php

@@ -4,31 +4,32 @@
  *
  * @license    GPL 2 (http://www.gnu.org/licenses/gpl.html)
  * @author     Giuseppe Di Terlizzi <giuseppe.diterlizzi@gmail.com>
- * @copyright  (C) 2015, Giuseppe Di Terlizzi
+ * @copyright  (C) 2015-2023, Giuseppe Di Terlizzi
  */
 
-// must be run within Dokuwiki
-if(!defined('DOKU_INC')) die();
 
 /**
  * Class Semantic Action Plugin
  *
  * Add semantic data to DokuWiki
  */
-class action_plugin_semantic extends DokuWiki_Action_Plugin {
+class action_plugin_semantic extends DokuWiki_Action_Plugin
+{
 
     private $helper = null;
 
-  public function __construct() {
+    public function __construct()
+    {
         $this->helper = $this->loadHelper('semantic');
     }
 
     /**
      * Register events
      *
-   * @param  Doku_Event_Handler  $controller
+     * @param Doku_Event_Handler $controller handler
      */
-  public function register(Doku_Event_Handler $controller) {
+    public function register(Doku_Event_Handler $controller)
+    {
 
         if ($this->getConf('useJSONLD')) {
             $controller->register_hook('TPL_METAHEADER_OUTPUT', 'BEFORE', $this, 'website');
@@ -58,8 +59,11 @@ class action_plugin_semantic extends DokuWiki_Action_Plugin {
         $controller->register_hook('DOKUWIKI_STARTED', 'AFTER', $this, 'jsinfo');
     }
 
-
-    public function jsinfo(Doku_Event &$event, $param) {
+    /**
+     * Export JSON-JD in $JSONINFO array
+     */
+    public function jsinfo(Doku_Event &$event, $param)
+    {
 
         global $JSINFO;
 
@@ -72,10 +76,13 @@ class action_plugin_semantic extends DokuWiki_Action_Plugin {
     /**
      * Export in JSON-LD format
      *
-   * @param   Doku_Event &$event
+     * @param Doku_Event $event handler
+     * @param array      $param
+     *
      * @return string
      */
-  public function ajax(Doku_Event &$event, $param) {
+    public function ajax(Doku_Event &$event, $param)
+    {
 
         if ($event->data !== 'plugin_semantic') {
             return false;
@@ -90,51 +97,72 @@ class action_plugin_semantic extends DokuWiki_Action_Plugin {
         $export = $INPUT->str('export');
         $id     = $INPUT->str('id');
 
-    if (! $id) return false;
+        if (!$id) {
+            return false;
+        }
 
         $this->helper->getMetadata($id);
         $json_ld = $this->helper->getJsonLD();
 
-    $json = new JSON();
-
         header('Content-Type: application/ld+json');
-    print $json->encode($json_ld);
+        print json_encode($json_ld);
         return true;
 
     }
 
-
-  public function website(Doku_Event &$event, $param) {
-    $event->data["script"][] = array (
+    /**
+     * Expose JSON-JD WebSite schema
+     *
+     * @param Doku_Event $event handler
+     * @param array      $params
+     *
+     * @return void
+     */
+    public function website(Doku_Event &$event, $params)
+    {
+        $event->data["script"][] = array(
             "type"  => "application/ld+json",
-      "_data" => json_encode($this->helper->getWebSite()),
+            "_data" => json_encode($this->helper->getWebSite(), JSON_PRETTY_PRINT),
         );
     }
 
-
     /**
      * JSON-LD Event handler
      *
-   * @param  Doku_Event  &$event
+     * @param Doku_Event $event handler
+     * @param array      $params
+     *
+     * @return void
      */
-  public function json_ld(Doku_Event &$event, $param) {
+    public function json_ld(Doku_Event &$event, $params)
+    {
 
         global $ID;
 
         $this->helper->getMetadata($ID);
         $json_ld = $this->helper->getJsonLD();
 
-    if (! count($json_ld)) return false;
+        if (!count($json_ld)) {
+            return false;
+        }
 
-    $event->data["script"][] = array (
+        $event->data["script"][] = array(
             "type"  => "application/ld+json",
-      "_data" => json_encode($json_ld),
+            "_data" => json_encode($json_ld, JSON_PRETTY_PRINT),
         );
 
     }
 
-
-  public function meta_description(Doku_Event &$event, $params) {
+    /**
+     * Meta Description handler
+     *
+     * @param Doku_Event $event handler
+     * @param array      $params
+     *
+     * @return void
+     */
+    public function meta_description(Doku_Event &$event, $params)
+    {
 
         global $ID;
 
@@ -153,8 +181,16 @@ class action_plugin_semantic extends DokuWiki_Action_Plugin {
 
     }
 
-
-  public function meta_author(Doku_Event &$event, $params) {
+    /**
+     * Meta Description handler
+     *
+     * @param Doku_Event $event handler
+     * @param array      $params
+     *
+     * @return void
+     */
+    public function meta_author(Doku_Event &$event, $params)
+    {
 
         global $ID;
 
@@ -171,8 +207,16 @@ class action_plugin_semantic extends DokuWiki_Action_Plugin {
 
     }
 
-
-  public function meta_open_graph(Doku_Event &$event, $params) {
+    /**
+     * OpenGraph handler
+     *
+     * @param Doku_Event $event handler
+     * @param array      $params
+     *
+     * @return void
+     */
+    public function meta_open_graph(Doku_Event &$event, $params)
+    {
 
         global $ID;
 
@@ -180,7 +224,9 @@ class action_plugin_semantic extends DokuWiki_Action_Plugin {
 
         foreach ($this->helper->getOpenGraph() as $property => $content) {
 
-      if (! $content) continue;
+            if (!$content) {
+                continue;
+            }
 
             $event->data['meta'][] = array(
                 'property' => $property,
@@ -191,8 +237,16 @@ class action_plugin_semantic extends DokuWiki_Action_Plugin {
 
     }
 
-
-  public function meta_dublin_core(Doku_Event &$event, $params) {
+    /**
+     * Dublin Core handler
+     *
+     * @param Doku_Event $event handler
+     * @param array      $params
+     *
+     * @return void
+     */
+    public function meta_dublin_core(Doku_Event &$event, $params)
+    {
 
         global $ID;
 
@@ -200,7 +254,9 @@ class action_plugin_semantic extends DokuWiki_Action_Plugin {
 
         foreach ($this->helper->getDublinCore() as $name => $content) {
 
-      if (! $content) continue;
+            if (!$content) {
+                continue;
+            }
 
             $event->data['meta'][] = array(
                 'name'    => $name,

conf/default.php

@@ -12,4 +12,5 @@ $conf['useMetaDescription']   = 1;
 $conf['useMetaAuthor']        = 1;
 $conf['useDublinCore']        = 0;
 $conf['useOpenGraph']         = 0;
-$conf['excludedPages']        = '(wiki|playground)';
+$conf['excludedPages']        = '(wiki)';
+$conf['hideMail']             = 0;

conf/metadata.php

@@ -11,5 +11,6 @@ $meta['useDublinCore']        = array('onoff');
 $meta['useOpenGraph']         = array('onoff');
 $meta['useJSONLD']            = array('onoff');
 $meta['exposeWebService']     = array('onoff');
-$meta['defaultSchemaOrgType'] = array('multichoice','_choices' => array('Article', 'NewsArticle', 'TechArticle', 'BlogPosting', 'Recipe'));
+$meta['defaultSchemaOrgType'] = array('multichoice', '_choices' => array('Article', 'NewsArticle', 'TechArticle', 'BlogPosting', 'Recipe'));
 $meta['excludedPages']        = array('regex');
+$meta['hideMail']             = array('onoff');

helper.php

@@ -4,39 +4,50 @@
  *
  * @license    GPL 2 (http://www.gnu.org/licenses/gpl.html)
  * @author     Giuseppe Di Terlizzi <giuseppe.diterlizzi@gmail.com>
+ * @copyright  (C) 2015-2022, Giuseppe Di Terlizzi
  */
 
-// must be run within Dokuwiki
-if(!defined('DOKU_INC')) die();
-
-class helper_plugin_semantic extends DokuWiki_Plugin {
+class helper_plugin_semantic extends DokuWiki_Plugin
+{
 
     private $meta = array();
     private $page = null;
 
-
-  public function getWebSite() {
+    /**
+     * Get Schema.org WebSite
+     *
+     * @return array
+     */
+    public function getWebSite()
+    {
 
         global $conf;
 
         $json_ld = array(
-      '@context' => 'http://schema.org',
+            '@context'        => 'http://schema.org/',
             '@type'           => 'WebSite',
             'url'             => DOKU_URL,
             'name'            => $conf['title'],
             'potentialAction' => array(
                 '@type'       => 'SearchAction',
-        'target'      => DOKU_URL.DOKU_SCRIPT.'?do=search&amp;id={search_term_string}',
-        'query-input' => 'required name=search_term_string'
-      )
+                'target'      => DOKU_URL . DOKU_SCRIPT . '?do=search&amp;id={search_term_string}',
+                'query-input' => 'required name=search_term_string',
+            ),
         );
 
         return $json_ld;
 
     }
 
-
-  public function getMetadata($page) {
+    /**
+     * Get the metadata of the page
+     *
+     * @param string $page ID
+     *
+     * @return string
+     */
+    public function getMetadata($page)
+    {
 
         global $INFO;
         global $ID;
@@ -48,65 +59,134 @@ class helper_plugin_semantic extends DokuWiki_Plugin {
 
         $auth_check = auth_quickaclcheck($this->page);
 
-    if ((bool) preg_match('/'. trim($this->getConf('excludedPages')) .'/', $this->page)) return false;
-
-    if (! $auth_check) return false;
-
-    $this->meta = p_get_metadata($this->page);
-
-    if (isset($this->meta['plugin']['semantic']['enabled']) && ! $this->meta['plugin']['semantic']['enabled']) {
+        if ((bool) preg_match('/' . trim($this->getConf('excludedPages')) . '/', $this->page)) {
             return false;
         }
 
-    if (! isset($this->meta['date']) || $this->meta['date'] == '') return false;
+        if (!$auth_check) {
+            return false;
+        }
+
+        $this->meta = p_get_metadata($this->page);
+
+        if (isset($this->meta['plugin']['semantic']['enabled']) && !$this->meta['plugin']['semantic']['enabled']) {
+            return false;
+        }
+
+        if (!isset($this->meta['date']) || $this->meta['date'] == '') {
+            return false;
+        }
 
         return $this->meta;
 
     }
 
-  public function getSchemaOrgType() {
+    /**
+     * Get Schema.Org page type
+     *
+     * @return string
+     */
+    public function getSchemaOrgType()
+    {
 
         return ((isset($this->meta['plugin']['semantic']['schema.org']['type']))
             ? $this->meta['plugin']['semantic']['schema.org']['type']
             : $this->getConf('defaultSchemaOrgType'));
     }
 
-  public function getFirstImage() {
-    return ((@$this->meta['relation']['firstimage']) ? $this->meta['relation']['firstimage'] : null);
+    /**
+     * Get the first image in page
+     *
+     * @return string
+     */
+    public function getFirstImage()
+    {
+        return (isset($this->meta['relation']['firstimage']) ? $this->meta['relation']['firstimage'] : null);
     }
 
-  public function getFirstImageURL() {
+    /**
+     * Get the URL of the first image in page
+     *
+     * @return string
+     */
+    public function getFirstImageURL()
+    {
         return ($this->getFirstImage() ? ml($this->getFirstImage(), '', true, '&amp;', true) : null);
     }
 
-  public function getDescription() {
-    return (@$this->meta['description']['abstract'] ? $this->meta['description']['abstract']: $this->getTitle());
+    /**
+     * Get page description
+     *
+     * @return string
+     */
+    public function getDescription()
+    {
+        return (isset($this->meta['description']['abstract']) ? $this->meta['description']['abstract'] : $this->getTitle());
     }
 
-  public function getAuthor() {
-    return ($this->meta['creator'] ? $this->meta['creator'] : null);
+    /**
+     * Get author name
+     *
+     * @return string
+     */
+    public function getAuthor()
+    {
+        return ( array_key_exists('creator', $this->meta ) ?
+            $this->meta['creator'] : null;
     }
 
-  public function getAuthorID() {
-    return ($this->meta['user'] ? $this->meta['user'] : null);
+    /**
+     * Get author ID
+     *
+     * @return string
+     */
+    public function getAuthorID()
+    {
+        return ( array_key_exists('user', $this->meta ) ?
+            $this->meta['user'] : null;
     }
 
-  public function getTitle() {
-    return (@$this->meta['title'] ? $this->meta['title'] : null);
+    /**
+     * Get the page title
+     *
+     * @return string
+     */
+    public function getTitle()
+    {
+        return (isset($this->meta['title']) ? $this->meta['title'] : null);
     }
 
-  public function getCreatedDate() {
-    return ((@$this->meta['date']['created']) ? $this->meta['date']['created'] : -1);
+    /**
+     * Get the create date of page
+     *
+     * @return int
+     */
+    public function getCreatedDate()
+    {
+        return (isset($this->meta['date']['created']) ? $this->meta['date']['created'] : -1);
     }
 
-  public function getModifiedDate() {
-    return ((@$this->meta['date']['modified']) ? $this->meta['date']['modified'] : -1);
+    /**
+     * Get the modified date of page
+     *
+     * @return int
+     */
+    public function getModifiedDate()
+    {
+        return (isset($this->meta['date']['modified']) ? $this->meta['date']['modified'] : -1);
     }
 
-  public function getLicense() {
+    /**
+     * Get DokuWiki license
+     *
+     * @return string
+     */
+    public function getLicense()
+    {
         global $license;
         global $conf;
-    return @$license[$conf['license']];
+
+        return (isset($license[$conf['license']]) ? $license[$conf['license']] : null);
     }
 
     /**
@@ -114,16 +194,19 @@ class helper_plugin_semantic extends DokuWiki_Plugin {
      *
      * @return array
      */
-  public function getStructuredData() {
+    public function getStructuredData()
+    {
 
         global $auth;
         global $conf;
 
-    if (! count($this->meta)) return false;
+        if (!count($this->meta)) {
+            return false;
+        }
 
         $license        = $this->getLicense();
         $type           = $this->getSchemaOrgType();
-    $user_data      = $auth->getUserData($this->getAuthorID());
+        $user_data      = ($this->getConf('hideMail') ? array('mail' => null) : $auth->getUserData($this->getAuthorID()));
         $license_url    = $license['url'];
         $page_url       = wl($this->page, '', true);
         $description    = str_replace("\n", ' ', $this->getDescription());
@@ -133,9 +216,8 @@ class helper_plugin_semantic extends DokuWiki_Plugin {
         $wiki_logo_info = array();
         $wiki_logo      = tpl_getMediaFile(array(':wiki:logo.png', ':logo.png', 'images/logo.png'), true, $wiki_logo_info);
 
-
         $json_ld = array(
-      '@context'      => 'http://schema.org',
+            '@context'         => 'http://schema.org/',
             '@type'            => $type,
             'headline'         => $title,
             'name'             => $title,
@@ -158,7 +240,7 @@ class helper_plugin_semantic extends DokuWiki_Plugin {
                     '@type' => 'ImageObject',
                     'url'   => $wiki_logo,
                 ),
-      )
+            ),
 
         );
 
@@ -184,20 +266,22 @@ class helper_plugin_semantic extends DokuWiki_Plugin {
         if ($author = $this->getAuthor()) {
 
             $json_ld['author'] = array(
-        '@context' => 'http://schema.org',
+                '@context' => 'http://schema.org/',
                 '@type'    => 'Person',
                 'name'     => $author,
-        'email'    => $user_data['mail']
+                'email'    => $user_data['mail'],
             );
 
             if (isset($this->meta['contributor'])) {
                 foreach ($this->meta['contributor'] as $uid => $fullname) {
-          $contributor_data = $auth->getUserData($uid);
+
+                    $contributor_data = ($this->getConf('hideMail') ? array('mail' => null) : $auth->getUserData($uid));
+
                     $json_ld['contributor'][] = array(
-            '@context' => 'http://schema.org',
+                        '@context' => 'http://schema.org/',
                         '@type'    => 'Person',
                         'name'     => $fullname,
-            'email'    => $contributor_data['mail']
+                        'email'    => $contributor_data['mail'],
                     );
                 }
             }
@@ -208,8 +292,8 @@ class helper_plugin_semantic extends DokuWiki_Plugin {
 
     }
 
-
-  public function getJsonLD() {
+    public function getJsonLD()
+    {
 
         $json_ld = array();
 
@@ -225,30 +309,36 @@ class helper_plugin_semantic extends DokuWiki_Plugin {
 
     }
 
+    public function getBacklinks()
+    {
 
-  public function getBacklinks() {
-
-    if (! $backlinks = ft_backlinks($this->page)) return false;
+        if (!$backlinks = ft_backlinks($this->page)) {
+            return false;
+        }
 
         $json_ld_webpage = array(
-      '@context' => 'http://schema.org',
-      '@type'    => 'WebPage'
+            '@context' => 'http://schema.org/',
+            '@type'    => 'WebPage',
         );
 
         foreach ($backlinks as $pageid) {
             $json_ld_webpage['relatedLink'][] = wl($pageid, '', true);
         }
 
-    if (isset($json_ld_webpage['relatedLink'])) return $json_ld_webpage;
+        if (isset($json_ld_webpage['relatedLink'])) {
+            return $json_ld_webpage;
+        }
 
     }
 
-
-  public function getDublinCore() {
+    public function getDublinCore()
+    {
 
         global $conf;
 
-    if (! $this->meta) return array();
+        if (!$this->meta) {
+            return array();
+        }
 
         $license      = $this->getLicense();
         $contributors = array();
@@ -276,12 +366,14 @@ class helper_plugin_semantic extends DokuWiki_Plugin {
 
     }
 
-
-  public function getOpenGraph() {
+    public function getOpenGraph()
+    {
 
         global $conf;
 
-    if (! $this->meta) return array();
+        if (!$this->meta) {
+            return array();
+        }
 
         $locale = $conf['lang'];
 

lang/en/settings.php

@@ -15,3 +15,4 @@ $lang['useJSONLD']            = 'Add JSON-LD';
 $lang['useMetaAuthor']        = 'Add author meta tag';
 $lang['useMetaDescription']   = 'Add description meta tag';
 $lang['useOpenGraph']         = 'Add Open Graph protocol metadata';
+$lang['hideMail']             = 'Hide Author e-Mail address';

plugin.info.txt

@@ -1,7 +1,7 @@
 base semantic
-author Giuseppe Di Terlizzi
-email giuseppe.diterlizzi@gmail.com
-date 2018-08-25
+author Giuseppe Di Terlizzi, patched by vv221 for Numenaute
+email numenaute@vv221.fr
+date 2024-10-04
 name Semantic Plugin
 desc Add Semantic Data in DokuWiki
-url http://www.dokuwiki.org/plugin:semantic
+url https://git.vv221.fr/numenaute.org/dokuwiki-plugin-semantic/about/

syntax.php

@@ -4,23 +4,24 @@
  * 
  * @license    GPL 2 (http://www.gnu.org/licenses/gpl.html)
  * @author     Giuseppe Di Terlizzi <giuseppe.diterlizzi@gmail.com>
+ * @copyright  (C) 2015-2023, Giuseppe Di Terlizzi
  */
-// must be run within Dokuwiki
-if (!defined('DOKU_INC')) die();
 
-if (!defined('DOKU_PLUGIN')) define('DOKU_PLUGIN',DOKU_INC.'lib/plugins/');
-
-class syntax_plugin_semantic extends DokuWiki_Syntax_Plugin {
+class syntax_plugin_semantic extends DokuWiki_Syntax_Plugin
+{
 
     private $macros = array(
         '~~NewsArticle~~', '~~Article~~', '~~TechArticle~~',
-    '~~BlogPosting~~', '~~Recipe~~', '~~NOSEMANTIC~~'
+        '~~BlogPosting~~', '~~Recipe~~', '~~NOSEMANTIC~~',
     );
 
-  function getType() { return 'substition'; }
-  function getSort() { return 99; }
+    public function getType()
+    {return 'substition';}
+    public function getSort()
+    {return 99;}
 
-  function connectTo($mode) {
+    public function connectTo($mode)
+    {
 
         foreach ($this->macros as $macro) {
             $this->Lexer->addSpecialPattern($macro, $mode, 'plugin_semantic');
@@ -28,11 +29,13 @@ class syntax_plugin_semantic extends DokuWiki_Syntax_Plugin {
 
     }
 
-  function handle($match, $state, $pos, Doku_Handler $handler) {
+    public function handle($match, $state, $pos, Doku_Handler $handler)
+    {
         return array($match, $state, $pos);
     }
 
-  function render($mode, Doku_Renderer $renderer, $data) {
+    public function render($mode, Doku_Renderer $renderer, $data)
+    {
 
         if ($mode == 'metadata') {