Fix 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>

img/billing.svg

@@ -0,0 +1,82 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!-- Created with Inkscape (http://www.inkscape.org/) -->
+
+<svg
+   width="16"
+   height="16"
+   viewBox="0 0 4.2333332 4.2333333"
+   version="1.1"
+   id="svg1439"
+   inkscape:version="1.2.1 (9c6d41e410, 2022-07-14)"
+   sodipodi:docname="billing.svg"
+   xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
+   xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
+   xmlns="http://www.w3.org/2000/svg"
+   xmlns:svg="http://www.w3.org/2000/svg">
+  <sodipodi:namedview
+     id="namedview1441"
+     pagecolor="#ffffff"
+     bordercolor="#666666"
+     borderopacity="1.0"
+     inkscape:showpageshadow="2"
+     inkscape:pageopacity="0.0"
+     inkscape:pagecheckerboard="0"
+     inkscape:deskcolor="#d1d1d1"
+     inkscape:document-units="px"
+     showgrid="false"
+     inkscape:zoom="38.057741"
+     inkscape:cx="4.1910002"
+     inkscape:cy="5.9514831"
+     inkscape:window-width="2048"
+     inkscape:window-height="1089"
+     inkscape:window-x="0"
+     inkscape:window-y="0"
+     inkscape:window-maximized="1"
+     inkscape:current-layer="layer1" />
+  <defs
+     id="defs1436">
+    <inkscape:path-effect
+       effect="fillet_chamfer"
+       id="path-effect2197"
+       is_visible="true"
+       lpeversion="1"
+       nodesatellites_param="F,0,0,1,0,0.2,0,1 @ F,0,0,1,0,0.2,0,1 @ F,0,0,1,0,0.2,0,1 @ F,0,0,1,0,0.2,0,1 | F,0,0,1,0,0.2,0,1 @ F,0,0,1,0,0.2,0,1 @ F,0,0,1,0,0.2,0,1 @ F,0,0,1,0,0.2,0,1"
+       unit="px"
+       method="auto"
+       mode="F"
+       radius="0.2"
+       chamfer_steps="1"
+       flexible="false"
+       use_knot_distance="true"
+       apply_no_radius="true"
+       apply_with_radius="true"
+       only_selected="false"
+       hide_knots="false" />
+  </defs>
+  <g
+     inkscape:label="Layer 1"
+     inkscape:groupmode="layer"
+     id="layer1">
+    <path
+       id="rect1612"
+       style="stroke-width:1.06338;stroke-linecap:round;stroke-linejoin:round"
+       d="m 0,1.1260417 v 1.9812499 a 0.2,0.2 45 0 0 0.2,0.2 h 3.8333332 a 0.2,0.2 135 0 0 0.2,-0.2 V 1.1260417 a 0.2,0.2 45 0 0 -0.2,-0.20000005 l -3.8333332,0 A 0.2,0.2 135 0 0 0,1.1260417 Z M 0.59687499,1.3229166 H 3.6364583 a 0.2,0.2 45 0 1 0.2,0.2 v 1.1875 a 0.2,0.2 135 0 1 -0.2,0.2 H 0.59687499 a 0.2,0.2 45 0 1 -0.2,-0.2 v -1.1875 a 0.2,0.2 135 0 1 0.2,-0.2 z"
+       sodipodi:nodetypes="cccccccccc"
+       inkscape:path-effect="#path-effect2197"
+       inkscape:original-d="M 0,0.92604165 V 3.3072916 H 4.2333332 V 0.92604165 Z M 0.39687499,1.3229166 H 3.8364583 v 1.5875 H 0.39687499 Z" />
+    <circle
+       style="fill:#000000;stroke-width:0.803987;stroke-linecap:round;stroke-linejoin:round"
+       id="path1671"
+       cx="2.1166666"
+       cy="2.1166666"
+       r="0.52916664" />
+    <path
+       id="circle1934"
+       style="stroke-width:1.20598;stroke-linecap:round;stroke-linejoin:round"
+       d="m 4.2333332,1.3229166 v 1.5875 a 0.79374998,0.79375002 0 0 1 -0.79375,-0.7937501 0.79374998,0.79375002 0 0 1 0.79375,-0.7937499 z" />
+    <path
+       id="path1941"
+       style="stroke-width:1.20598;stroke-linecap:round;stroke-linejoin:round"
+       d="m 0,1.3229166 v 1.5875 A 0.79374998,0.79375002 0 0 0 0.79374998,2.1166665 0.79374998,0.79375002 0 0 0 0,1.3229166 Z" />
+  </g>
+</svg>

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 Billing 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 1;
+    }
+}

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>

templates/settings/billing.php

@@ -0,0 +1,32 @@
+<?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/>.
+ *
+ */
+?>
+<?php if ($_['billingUrl']) { ?>
+<div id="security-external-password" class="section">
+	<h2><?php p($l->t('Billing'));?></h2>
+    <div>
+        <p class="settings-hint"><?php p($_['billingDescriptionText']); ?></p>
+        <p><a href="<?php p($_['billingUrl']); ?>" class="button" target="_blank"><?php p($_['billingButtonText']); ?></a></p>
+    </div>
+</div>
+<?php } ?>