Add billing section

appinfo/info.xml

@@ -20,5 +20,7 @@
     <settings>
         <admin>OCA\ExternalPassword\Settings\Admin</admin>
         <personal>OCA\ExternalPassword\Settings\Personal</personal>
+        <personal>OCA\ExternalPassword\Settings\Billing</personal>
+        <personal-section>OCA\ExternalPassword\Sections\Billing</personal-section>
     </settings>
 </info>

lib/Controller/SettingsController.php

@@ -47,10 +47,14 @@ class SettingsController extends Controller {
      * @param string $descriptionText
      * @param string $buttonText
 	 */
-	public function save(string $changePasswordUrl, string $descriptionText, string $buttonText): JSONResponse {
+    public function save(string $changePasswordUrl, string $descriptionText, string $buttonText,
+                         string $billingUrl, string $billingDescriptionText, string $billingButtonText): JSONResponse {
         $this->config->setAppValue('externalpassword', 'changePasswordUrl', $changePasswordUrl);
         $this->config->setAppValue('externalpassword', 'descriptionText', $descriptionText);
         $this->config->setAppValue('externalpassword', 'buttonText', $buttonText);
+        $this->config->setAppValue('externalpassword', 'billingUrl', $billingUrl);
+        $this->config->setAppValue('externalpassword', 'billingDescriptionText', $billingDescriptionText);
+        $this->config->setAppValue('externalpassword', 'billingButtonText', $billingButtonText);
         $parameters = [
             'status' => 'success',
             'data' => [

lib/Sections/Billing.php

@@ -0,0 +1,32 @@
+<?php
+namespace OCA\ExternalPassword\Sections;
+
+use OCP\IL10N;
+use OCP\IURLGenerator;
+use OCP\Settings\IIconSection;
+
+class BillingSection implements IIconSection {
+    private IL10N $l;
+    private IURLGenerator $urlGenerator;
+
+    public function __construct(IL10N $l, IURLGenerator $urlGenerator) {
+        $this->l = $l;
+        $this->urlGenerator = $urlGenerator;
+    }
+
+    public function getIcon(): string {
+        return $this->urlGenerator->imagePath('externalpassword', 'billing.svg');
+    }
+
+    public function getID(): string {
+        return 'billing';
+    }
+
+    public function getName(): string {
+        return $this->l->t('Billing');
+    }
+
+    public function getPriority(): int {
+        return 98;
+    }
+}

lib/Settings/Admin.php

@@ -50,14 +50,24 @@ class Admin implements ISettings {
      * @return TemplateResponse
      */
     public function getForm() {
+        # Password section
         $changePasswordUrl = $this->config->getAppValue('externalpassword', 'changePasswordUrl', '');
         $descriptionText = $this->config->getAppValue('externalpassword', 'descriptionText',
             'Your password is managed externally, please click the button below to change your password.');
         $buttonText = $this->config->getAppValue('externalpassword', 'buttonText', 'Change password');
+        # Billing section
+        $billingUrl = $this->config->getAppValue('externalpassword', 'billingUrl', '');
+        $billingDescriptionText = $this->config->getAppValue('externalpassword', 'billingDescriptionText',
+            'Your account billing is managed externally, please click the button below to manage your account.');
+        $billingButtonText = $this->config->getAppValue('externalpassword', 'billingButtonText', 'Manage billing');
+
         $parameters = [
             'changePasswordUrl' => $changePasswordUrl,
             'descriptionText' => $descriptionText,
-            'buttonText' => $buttonText
+            'buttonText' => $buttonText,
+            'billingUrl' => $billingUrl,
+            'billingDescriptionText' => $billingDescriptionText,
+            'billingButtonText' => $billingButtonText
         ];
         return new TemplateResponse('externalpassword', 'settings/admin', $parameters);
     }

lib/Settings/Billing.php

@@ -0,0 +1,87 @@
+<?php
+/**
+ * @copyright Copyright (c) 2022 Raoul Snyman <raoul@snyman.info>
+ *
+ * @author Raoul Snyman <raoul@snyman.info>
+ *
+ * @license GNU AGPL version 3 or any later version
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as
+ * published by the Free Software Foundation, either version 3 of the
+ * License, or (at your option) any later version.
+ *
+ * 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 Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ *
+ */
+namespace OCA\ExternalPassword\Settings;
+
+use OCP\AppFramework\Http\TemplateResponse;
+use OCP\IConfig;
+use OCP\IL10N;
+use OCP\Settings\ISettings;
+
+class Billing implements ISettings {
+
+    /** @var IConfig */
+    private $config;
+
+    /** @var IL10N */
+    private $l;
+
+    /**
+     * Admin constructor.
+     *
+     * @param IConfig $config
+     * @param IL10N $l
+     */
+    public function __construct(IConfig $config, IL10N $l) {
+        $this->config = $config;
+        $this->l = $l;
+    }
+
+    /**
+     * @return TemplateResponse
+     */
+    public function getForm() {
+        $billingUrl = $this->config->getAppValue('externalpassword', 'billingUrl', '');
+        $billingDescriptionText = $this->config->getAppValue('externalpassword', 'billingDescriptionText',
+            'Your account billing is managed externally, please click the button below to manage your account.');
+        $billingButtonText = $this->config->getAppValue('externalpassword', 'billingButtonText', 'Manage billing');
+        $parameters = [
+            'billingUrl' => $billingUrl,
+            'billingDescriptionText' => $billingDescriptionText,
+            'billingButtonText' => $billingButtonText
+        ];
+        return new TemplateResponse('externalpassword', 'settings/billing', $parameters);
+    }
+
+    /**
+     * @return string the section ID, e.g. 'sharing'
+     */
+    public function getSection() {
+        $billingUrl = $this->config->getAppValue('externalpassword', 'billingUrl', '');
+        if (!$billingUrl) {
+            return null;
+        }
+        else {
+            return 'billing';
+        }
+    }
+
+    /**
+     * @return int whether the form should be rather on the top or bottom of
+     * the admin section. The forms are arranged in ascending order of the
+     * priority values. It is required to return a value between 0 and 100.
+     */
+    public function getPriority() {
+        return 10;
+    }
+
+}

templates/settings/admin.php

@@ -27,7 +27,7 @@ style('externalpassword', 'admin');
 <div id="security-externalpassword" class="section">
     <h2 class="inlineblock"><?php p($l->t('External Password'));?></h2>
     <span id="externalpassword-error-msg" class="msg success hidden">Saved</span>
-    <p class="settings-hint"><?php p($l->t('To direct users to an external website in order to change their password, set the URL below.')); ?></p>
+    <p class="settings-hint"><?php p($l->t('To direct users to an external website in order to change their password or update their billing, set the URLs below.')); ?></p>
     <div class="admin-settings-externalpassword">
         <form id="externalpassword-form" method="POST">
             <div class="form-section">
@@ -35,13 +35,25 @@ style('externalpassword', 'admin');
                 <input type="text" id="change-password-url" name="changePasswordUrl" value="<?php p($_['changePasswordUrl']); ?>" />
             </div>
             <div class="form-section">
-                <label for="description-text"><?php p($l->t('Description')); ?></label>
+                <label for="description-text"><?php p($l->t('Password description')); ?></label>
                 <input type="text" id="description-text" name="descriptionText" value="<?php p($_['descriptionText']); ?>" />
             </div>
             <div class="form-section">
-                <label for="button-text"><?php p($l->t('Button text')); ?></label>
+                <label for="button-text"><?php p($l->t('Password button text')); ?></label>
                 <input type="text" id="button-text" name="buttonText" value="<?php p($_['buttonText']); ?>" class="small" />
             </div>
+            <div class="form-section">
+                <label for="billing-url"><?php p($l->t('External billing URL')); ?></label>
+                <input type="text" id="billing-url" name="billingUrl" value="<?php p($_['billingUrl']); ?>" />
+            </div>
+            <div class="form-section">
+                <label for="billing-description-text"><?php p($l->t('Billing description')); ?></label>
+                <input type="text" id="billing-description-text" name="billingDescriptionText" value="<?php p($_['billingDescriptionText']); ?>" />
+            </div>
+            <div class="form-section">
+                <label for="billing-button-text"><?php p($l->t('Billing button text')); ?></label>
+                <input type="text" id="billing-button-text" name="billingButtonText" value="<?php p($_['billingButtonText']); ?>" class="small" />
+            </div>
             <input type="submit" id="externalpassword-save" value="<?php p($l->t('Save')); ?>" />
         </form>
     </div>