first commit

plugins/user/terms/forms/terms.xml

@@ -0,0 +1,21 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<form>
+	<fields name="terms">
+		<fieldset
+			name="terms"
+			label="PLG_USER_TERMS_LABEL"
+		>
+			<field
+				name="terms"
+				type="terms"
+				label="PLG_USER_TERMS_FIELD_LABEL"
+				default="0"
+				filter="integer"
+				required="true"
+				>
+				<option value="1">PLG_USER_TERMS_OPTION_AGREE</option>
+				<option value="0">PLG_USER_TERMS_OPTION_DO_NOT_AGREE</option>
+			</field>
+		</fieldset>
+	</fields>
+</form>

plugins/user/terms/services/provider.php

@@ -0,0 +1,46 @@
+<?php
+
+/**
+ * @package     Joomla.Plugin
+ * @subpackage  User.terms
+ *
+ * @copyright   (C) 2023 Open Source Matters, Inc. <https://www.joomla.org>
+ * @license     GNU General Public License version 2 or later; see LICENSE.txt
+ */
+
+\defined('_JEXEC') or die;
+
+use Joomla\CMS\Extension\PluginInterface;
+use Joomla\CMS\Factory;
+use Joomla\CMS\Plugin\PluginHelper;
+use Joomla\DI\Container;
+use Joomla\DI\ServiceProviderInterface;
+use Joomla\Event\DispatcherInterface;
+use Joomla\Plugin\User\Terms\Extension\Terms;
+
+return new class () implements ServiceProviderInterface {
+    /**
+     * Registers the service provider with a DI container.
+     *
+     * @param   Container  $container  The DI container.
+     *
+     * @return  void
+     *
+     * @since   4.4.0
+     */
+    public function register(Container $container): void
+    {
+        $container->set(
+            PluginInterface::class,
+            function (Container $container) {
+                $plugin     = new Terms(
+                    $container->get(DispatcherInterface::class),
+                    (array) PluginHelper::getPlugin('user', 'terms')
+                );
+                $plugin->setApplication(Factory::getApplication());
+
+                return $plugin;
+            }
+        );
+    }
+};

plugins/user/terms/src/Extension/Terms.php

@@ -0,0 +1,145 @@
+<?php
+
+/**
+ * @package     Joomla.Plugin
+ * @subpackage  User.terms
+ *
+ * @copyright   (C) 2018 Open Source Matters, Inc. <https://www.joomla.org>
+ * @license     GNU General Public License version 2 or later; see LICENSE.txt
+ */
+
+namespace Joomla\Plugin\User\Terms\Extension;
+
+use Joomla\CMS\Form\Form;
+use Joomla\CMS\Form\FormHelper;
+use Joomla\CMS\Plugin\CMSPlugin;
+use Joomla\Component\Actionlogs\Administrator\Model\ActionlogModel;
+use Joomla\Utilities\ArrayHelper;
+
+// phpcs:disable PSR1.Files.SideEffects
+\defined('_JEXEC') or die;
+// phpcs:enable PSR1.Files.SideEffects
+
+/**
+ * An example custom terms and conditions plugin.
+ *
+ * @since  3.9.0
+ */
+final class Terms extends CMSPlugin
+{
+    /**
+     * Adds additional fields to the user registration form
+     *
+     * @param   Form   $form  The form to be altered.
+     * @param   mixed  $data  The associated data for the form.
+     *
+     * @return  boolean
+     *
+     * @since   3.9.0
+     */
+    public function onContentPrepareForm(Form $form, $data)
+    {
+        // Check we are manipulating a valid form - we only display this on user registration form.
+        $name = $form->getName();
+
+        if (!\in_array($name, ['com_users.registration'])) {
+            return true;
+        }
+
+        // Load plugin language files
+        $this->loadLanguage();
+
+        // Add the terms and conditions fields to the form.
+        FormHelper::addFieldPrefix('Joomla\\Plugin\\User\\Terms\\Field');
+        FormHelper::addFormPath(JPATH_PLUGINS . '/' . $this->_type . '/' . $this->_name . '/forms');
+        $form->loadFile('terms');
+
+        $termsarticle = $this->params->get('terms_article');
+        $termsnote    = $this->params->get('terms_note');
+
+        // Push the terms and conditions article ID into the terms field.
+        $form->setFieldAttribute('terms', 'article', $termsarticle, 'terms');
+        $form->setFieldAttribute('terms', 'note', $termsnote, 'terms');
+    }
+
+    /**
+     * Method is called before user data is stored in the database
+     *
+     * @param   array    $user   Holds the old user data.
+     * @param   boolean  $isNew  True if a new user is stored.
+     * @param   array    $data   Holds the new user data.
+     *
+     * @return  boolean
+     *
+     * @since   3.9.0
+     * @throws  \InvalidArgumentException on missing required data.
+     */
+    public function onUserBeforeSave($user, $isNew, $data)
+    {
+        // // Only check for front-end user registration
+        if ($this->getApplication()->isClient('administrator')) {
+            return true;
+        }
+
+        $userId = ArrayHelper::getValue($user, 'id', 0, 'int');
+
+        // User already registered, no need to check it further
+        if ($userId > 0) {
+            return true;
+        }
+
+        // Load plugin language files
+        $this->loadLanguage();
+
+        // Check that the terms is checked if required ie only in registration from frontend.
+        $input  = $this->getApplication()->getInput();
+        $option = $input->get('option');
+        $task   = $input->post->get('task');
+        $form   = $input->post->get('jform', [], 'array');
+
+        if ($option == 'com_users' && \in_array($task, ['registration.register']) && empty($form['terms']['terms'])) {
+            throw new \InvalidArgumentException($this->getApplication()->getLanguage()->_('PLG_USER_TERMS_FIELD_ERROR'));
+        }
+
+        return true;
+    }
+
+    /**
+     * Saves user profile data
+     *
+     * @param   array    $data    entered user data
+     * @param   boolean  $isNew   true if this is a new user
+     * @param   boolean  $result  true if saving the user worked
+     * @param   string   $error   error message
+     *
+     * @return  void
+     *
+     * @since   3.9.0
+     */
+    public function onUserAfterSave($data, $isNew, $result, $error): void
+    {
+        if (!$isNew || !$result) {
+            return;
+        }
+
+        $userId = ArrayHelper::getValue($data, 'id', 0, 'int');
+
+        $message = [
+            'action'      => 'consent',
+            'id'          => $userId,
+            'title'       => $data['name'],
+            'itemlink'    => 'index.php?option=com_users&task=user.edit&id=' . $userId,
+            'userid'      => $userId,
+            'username'    => $data['username'],
+            'accountlink' => 'index.php?option=com_users&task=user.edit&id=' . $userId,
+        ];
+
+        /** @var ActionlogModel $model */
+        $model = $this->getApplication()
+            ->bootComponent('com_actionlogs')
+            ->getMVCFactory()
+            ->createModel('Actionlog', 'Administrator');
+
+        $model->addLog([$message], 'PLG_USER_TERMS_LOGGING_CONSENT_TO_TERMS', 'plg_user_terms', $userId);
+    }
+}

plugins/user/terms/src/Field/TermsField.php

@@ -0,0 +1,125 @@
+<?php
+
+/**
+ * @package     Joomla.Plugin
+ * @subpackage  User.terms
+ *
+ * @copyright   (C) 2018 Open Source Matters, Inc. <https://www.joomla.org>
+ * @license     GNU General Public License version 2 or later; see LICENSE.txt
+ */
+
+namespace Joomla\Plugin\User\Terms\Field;
+
+use Joomla\CMS\Factory;
+use Joomla\CMS\Form\Field\RadioField;
+use Joomla\CMS\Language\Associations;
+use Joomla\CMS\Language\Text;
+use Joomla\Component\Content\Site\Helper\RouteHelper;
+use Joomla\Database\ParameterType;
+
+// phpcs:disable PSR1.Files.SideEffects
+\defined('_JEXEC') or die;
+// phpcs:enable PSR1.Files.SideEffects
+
+/**
+ * Provides input for privacyterms
+ *
+ * @since  3.9.0
+ */
+class TermsField extends RadioField
+{
+    /**
+     * The form field type.
+     *
+     * @var    string
+     * @since  3.9.0
+     */
+    protected $type = 'terms';
+
+    /**
+     * Method to get the field input markup.
+     *
+     * @return  string   The field input markup.
+     *
+     * @since   3.9.0
+     */
+    protected function getInput()
+    {
+        // Display the message before the field
+        echo $this->getRenderer('plugins.user.terms.message')->render($this->getLayoutData());
+
+        return parent::getInput();
+    }
+
+    /**
+     * Method to get the field label markup.
+     *
+     * @return  string  The field label markup.
+     *
+     * @since   3.9.0
+     */
+    protected function getLabel()
+    {
+        if ($this->hidden) {
+            return '';
+        }
+
+        return $this->getRenderer('plugins.user.terms.label')->render($this->getLayoutData());
+    }
+
+    /**
+     * Method to get the data to be passed to the layout for rendering.
+     *
+     * @return  array
+     *
+     * @since   3.9.4
+     */
+    protected function getLayoutData()
+    {
+        $data = parent::getLayoutData();
+
+        $article      = false;
+        $termsArticle = $this->element['article'] > 0 ? (int) $this->element['article'] : 0;
+
+        if ($termsArticle && Factory::getApplication()->isClient('site')) {
+            $db    = $this->getDatabase();
+            $query = $db->getQuery(true)
+                ->select($db->quoteName(['id', 'alias', 'catid', 'language']))
+                ->from($db->quoteName('#__content'))
+                ->where($db->quoteName('id') . ' = :id')
+                ->bind(':id', $termsArticle, ParameterType::INTEGER);
+            $db->setQuery($query);
+            $article = $db->loadObject();
+
+            if (Associations::isEnabled()) {
+                $termsAssociated = Associations::getAssociations('com_content', '#__content', 'com_content.item', $termsArticle);
+            }
+
+            $currentLang = Factory::getLanguage()->getTag();
+
+            if (isset($termsAssociated) && $currentLang !== $article->language && \array_key_exists($currentLang, $termsAssociated)) {
+                $article->link = RouteHelper::getArticleRoute(
+                    $termsAssociated[$currentLang]->id,
+                    $termsAssociated[$currentLang]->catid,
+                    $termsAssociated[$currentLang]->language
+                );
+            } else {
+                $slug          = $article->alias ? ($article->id . ':' . $article->alias) : $article->id;
+                $article->link = RouteHelper::getArticleRoute($slug, $article->catid, $article->language);
+            }
+        }
+
+        $extraData = [
+            'termsnote'            => !empty($this->element['note']) ? $this->element['note'] : Text::_('PLG_USER_TERMS_NOTE_FIELD_DEFAULT'),
+            'options'              => $this->getOptions(),
+            'value'                => (string) $this->value,
+            'translateLabel'       => $this->translateLabel,
+            'translateDescription' => $this->translateDescription,
+            'translateHint'        => $this->translateHint,
+            'termsArticle'         => $termsArticle,
+            'article'              => $article,
+        ];
+
+        return array_merge($data, $extraData);
+    }
+}

plugins/user/terms/terms.xml

@@ -0,0 +1,50 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<extension type="plugin" group="user" method="upgrade">
+	<name>plg_user_terms</name>
+	<author>Joomla! Project</author>
+	<creationDate>2018-06</creationDate>
+	<copyright>(C) 2018 Open Source Matters, Inc.</copyright>
+	<license>GNU General Public License version 2 or later; see LICENSE.txt</license>
+	<authorEmail>admin@joomla.org</authorEmail>
+	<authorUrl>www.joomla.org</authorUrl>
+	<version>3.9.0</version>
+	<description>PLG_USER_TERMS_XML_DESCRIPTION</description>
+	<namespace path="src">Joomla\Plugin\User\Terms</namespace>
+	<files>
+		<folder>forms</folder>
+		<folder plugin="terms">services</folder>
+		<folder>src</folder>
+	</files>
+	<languages>
+		<language tag="en-GB">language/en-GB/plg_user_terms.ini</language>
+		<language tag="en-GB">language/en-GB/plg_user_terms.sys.ini</language>
+	</languages>
+	<config>
+		<fields name="params">
+			<fieldset name="basic" addfieldprefix="Joomla\Component\Content\Administrator\Field">
+				<field
+					name="terms_note"
+					type="textarea"
+					label="PLG_USER_TERMS_NOTE_FIELD_LABEL"
+					description="PLG_USER_TERMS_NOTE_FIELD_DESC"
+					hint="PLG_USER_TERMS_NOTE_FIELD_DEFAULT"
+					rows="7"
+					cols="20"
+					filter="html"
+				/>
+
+				<field
+					name="terms_article"
+					type="modal_article"
+					label="PLG_USER_TERMS_FIELD_ARTICLE_LABEL"
+					description="PLG_USER_TERMS_FIELD_ARTICLE_DESC"
+					select="true"
+					new="true"
+					edit="true"
+					clear="true"
+					filter="integer"
+				/>
+			</fieldset>
+		</fields>
+	</config>
+</extension>