cms/build/helpTOC.php

<?php
/**
 * @package    Joomla.Build
 *
 * @copyright  Copyright (C) 2005 - 2019 Open Source Matters, Inc. All rights reserved.
 * @license    GNU General Public License version 2 or later; see LICENSE.txt
 */

// Set flag that this is a parent file.
const _JEXEC = 1;

// Import namespaced classes
use Joomla\CMS\Application\CliApplication;
use Joomla\CMS\Factory;
use Joomla\CMS\Http\HttpFactory;
use Joomla\CMS\Version;
use Joomla\Registry\Registry;

// Load system defines
if (file_exists(dirname(__DIR__) . '/defines.php'))
{
	require_once dirname(__DIR__) . '/defines.php';
}

if (!defined('_JDEFINES'))
{
	define('JPATH_BASE', dirname(__DIR__));
	require_once JPATH_BASE . '/includes/defines.php';
}

// Get the framework.
require_once JPATH_LIBRARIES . '/bootstrap.php';

// Configure error reporting to maximum for CLI output.
error_reporting(E_ALL);
ini_set('display_errors', 1);

// Load the admin en-GB.ini language file to get the JHELP language keys
Factory::getLanguage()->load('joomla', JPATH_ADMINISTRATOR, null, false, false);

/**
 * Utility CLI to retrieve the list of help screens from the docs wiki and create an index for the admin help view.
 *
 * @since  3.0
 */
class MediawikiCli extends CliApplication
{
	/**
	 * Entry point for CLI script
	 *
	 * @return  void
	 *
	 * @since   3.0
	 */
	public function doExecute()
	{
		if (!class_exists(\Joomla\Mediawiki\Http::class))
		{
			$this->out(
				'The `joomla/mediawiki` package is not installed.  To use this script, you must run `composer install` to install development'
				. ' dependencies not tracked in this repo.'
			);

			return;
		}

		// Get the version data for the script
		$minorVersion = Version::MAJOR_VERSION . '.' . Version::MINOR_VERSION;
		$namespace    = 'Help' . str_replace('.', '', $minorVersion) . ':';

		// Set up HTTP driver for MediaWiki
		$http = new \Joomla\Mediawiki\Http([], HttpFactory::getAvailableDriver());

		// Set up options for JMediawiki
		$options = new Registry;
		$options->set('api.url', 'https://docs.joomla.org');

		$mediawiki = new Joomla\Mediawiki\Mediawiki($options, $http);

		// Get the category members (local hack)
		$this->out('Fetching data from docs wiki', true);
		$categoryMembers = $mediawiki->categories->getCategoryMembers('Category:Help_screen_' . $minorVersion, null, 'max');

		$members = array();

		// Loop through the result objects to get every document
		foreach ($categoryMembers->query->categorymembers as $catmembers)
		{
			foreach ($catmembers as $member)
			{
				$members[] = (string) $member['title'];
			}
		}

		// Get the language object
		$language = Factory::getLanguage();

		// Get the language strings via Reflection as the property is protected
		$refl = new ReflectionClass($language);
		$property = $refl->getProperty('strings');
		$property->setAccessible(true);
		$strings = $property->getValue($language);

		/*
		 * Now we start fancy processing so we can get the language key for the titles
		 */

		$cleanMembers = array();

		// Strip the namespace prefix off the titles and replace spaces with underscores
		foreach ($members as $member)
		{
			$cleanMembers[] = str_replace(array($namespace, ' '), array('', '_'), $member);
		}

		// Make sure we only have an array of unique values before continuing
		$cleanMembers = array_unique($cleanMembers);

		/*
		 * Loop through the cleaned up title array and the language strings array to match things up
		 */

		$matchedMembers = array();

		foreach ($cleanMembers as $member)
		{
			foreach ($strings as $k => $v)
			{
				if ($member === $v)
				{
					$matchedMembers[] = $k;

					continue;
				}
			}
		}

		// Alpha sort the array
		asort($matchedMembers);

		// Now we strip off the JHELP_ prefix from the strings to get usable strings for both COM_ADMIN and JHELP
		$stripped = array();

		foreach ($matchedMembers as $member)
		{
			$stripped[] = str_replace('JHELP_', '', $member);
		}

		/*
		 * Check to make sure a COM_ADMIN_HELP string exists, don't include in the TOC if not
		 */

		// Load the admin com_admin language file
		$language->load('com_admin', JPATH_ADMINISTRATOR);

		$toc = array();

		foreach ($stripped as $string)
		{
			// Validate the key exists
			$this->out('Validating key COM_ADMIN_HELP_' . $string, true);

			if ($language->hasKey('COM_ADMIN_HELP_' . $string))
			{
				$this->out('Adding ' . $string, true);

				$toc[$string] = $string;
			}
			// We check if the string for words in singular/plural form and check again
			else
			{
				$this->out('Inflecting ' . $string, true);

				if (strpos($string, '_CATEGORIES') !== false)
				{
					$inflected = str_replace('_CATEGORIES', '_CATEGORY', $string);
				}
				elseif (strpos($string, '_USERS') !== false)
				{
					$inflected = str_replace('_USERS', '_USER', $string);
				}
				elseif (strpos($string, '_CATEGORY') !== false)
				{
					$inflected = str_replace('_CATEGORY', '_CATEGORIES', $string);
				}
				elseif (strpos($string, '_USER') !== false)
				{
					$inflected = str_replace('_USER', '_USERS', $string);
				}
				else
				{
					$inflected = '';
				}

				// Now try to validate the key
				if ($inflected !== '')
				{
					$this->out('Validating key COM_ADMIN_HELP_' . $inflected, true);

					if ($language->hasKey('COM_ADMIN_HELP_' . $inflected))
					{
						$this->out('Adding ' . $inflected, true);

						$toc[$string] = $inflected;
					}
				}
			}
		}

		$this->out('Number of strings: ' . count($toc), true);

		// JSON encode the file and write it to JPATH_ADMINISTRATOR/help/en-GB/toc.json
		file_put_contents(JPATH_ADMINISTRATOR . '/help/en-GB/toc.json', json_encode($toc));

		$this->out('Help Screen TOC written', true);
	}
}

// Set up the container
Factory::getContainer()->share(
	'MediawikiCli',
	function (\Joomla\DI\Container $container)
	{
		return new MediawikiCli(
			null,
			null,
			null,
			null,
			$container->get(\Joomla\Event\DispatcherInterface::class),
			$container
		);
	},
	true
);
$app = Factory::getContainer()->get('MediawikiCli');
Factory::$application = $app;
$app->execute();