Admin > Settings

Author: soatok

public/static/faqoff.css

@@ -308,4 +308,8 @@ i.color-error {
 #admin-contributors-list li {
     display: inline-block;
     margin-right: 0.5rem;
-}
+}
+#settings-contents {
+    font-family: monospace;
+    min-height: 30rem;
+}

src/FaqOff/Endpoints/Admin/Settings.php

@@ -3,9 +3,12 @@
 namespace Soatok\FaqOff\Endpoints\Admin;
 
 use Interop\Container\Exception\ContainerException;
+use ParagonIE\Ionizer\InvalidDataException;
 use Psr\Http\Message\RequestInterface;
 use Psr\Http\Message\ResponseInterface;
 use Soatok\AnthroKit\Endpoint;
+use Soatok\FaqOff\Filter\AdminEditSettingsFilter;
+use Soatok\FaqOff\MessageOnceTrait;
 use Twig\Error\LoaderError;
 use Twig\Error\RuntimeError;
 use Twig\Error\SyntaxError;
@@ -16,12 +19,70 @@
  */
 class Settings extends Endpoint
 {
+    use MessageOnceTrait;
+
+    private $editable = [
+        'admins.json',
+        'anthrokit.php',
+        'settings.php'
+    ];
+
+    /**
+     * @param RequestInterface $request
+     * @param string $file
+     * @return ResponseInterface
+     * @throws ContainerException
+     * @throws InvalidDataException
+     * @throws LoaderError
+     * @throws RuntimeError
+     * @throws SyntaxError
+     */
+    protected function editFile(
+        RequestInterface $request,
+        string $file
+    ): ResponseInterface {
+        $filter = new AdminEditSettingsFilter();
+        $post = $this->post($request, self::TYPE_FORM, $filter);
+        if ($post) {
+            $written = file_put_contents(
+                APP_ROOT . '/local/' . $file,
+                $post['contents']
+            );
+            if (!is_bool($written)) {
+                $this->messageOnce('File saved successfully!', 'success');
+                return $this->redirect(
+                    '/admin/settings/edit?' .
+                    http_build_query(['file' => $file])
+                );
+            } else {
+                $contents = $post['contents'];
+                $this->messageOnce('File could not be saved. Please check its permissions.', 'error');
+            }
+        } else {
+            if (!file_exists(APP_ROOT . '/local/' . $file)) {
+                touch(APP_ROOT . '/local/' . $file);
+            }
+            $contents = file_get_contents(APP_ROOT . '/local/' . $file);
+        }
+        if (empty($contents)) {
+            $contents = '';
+        }
+        return $this->view(
+            'admin/settings-edit.twig',
+            [
+                'file' => $file,
+                'contents' => $contents
+            ]
+        );
+    }
+
     /**
      * @param RequestInterface $request
      * @param ResponseInterface|null $response
      * @param array $routerParams
      * @return ResponseInterface
      * @throws ContainerException
+     * @throws InvalidDataException
      * @throws LoaderError
      * @throws RuntimeError
      * @throws SyntaxError
@@ -31,6 +92,20 @@ public function __invoke(
         ?ResponseInterface $response = null,
         array $routerParams = []
     ): ResponseInterface {
-        return $this->json($routerParams);
+        $which = $routerParams['which'] ?? '';
+        switch ($which) {
+            case 'edit':
+                $file = $_GET['file'] ?? '';
+                if ($file) {
+                    if (in_array($file, $this->editable, true)) {
+                        return $this->editFile($request, $file);
+                    }
+                }
+                return $this->redirect('/admin/settings');
+            case '':
+                return $this->view('admin/settings-index.twig');
+            default:
+                return $this->redirect('/admin/settings');
+        }
     }
 }

src/FaqOff/Filter/AdminEditSettingsFilter.php

@@ -0,0 +1,18 @@
+<?php
+declare(strict_types=1);
+namespace Soatok\FaqOff\Filter;
+
+use ParagonIE\Ionizer\Filter\StringFilter;
+use ParagonIE\Ionizer\InputFilterContainer;
+
+/**
+ * Class AdminEditSettingsFilter
+ * @package Soatok\FaqOff\Filter
+ */
+class AdminEditSettingsFilter extends InputFilterContainer
+{
+    public function __construct()
+    {
+        $this->addFilter('contents', new StringFilter());
+    }
+}

src/routes.php

@@ -29,7 +29,7 @@
     $app->get('/collections', 'admin.collections');
     $app->any('/custom[/{action:[^/]+}]', 'admin.custom');
     $app->get('/invite-tree', 'admin.invitetree');
-    $app->get('/settings[/{which:[^/]+}]', 'admin.settings');
+    $app->any('/settings[/{which:[^/]+}]', 'admin.settings');
     $app->any('/theme/{action:[^/]+}/[{id:[0-9]+}]', 'admin.themes');
     $app->any('/theme[/{action:[^/]+}]', 'admin.themes');
     $app->get('/themes', 'admin.themes');

templates/admin/settings-edit.twig

@@ -0,0 +1,16 @@
+{% extends "base.twig" %}
+
+{% block main %}
+    <h2>Edit File {{ file }}</h2>
+    <form method="post">
+        {{ anti_csrf() }}
+        <label for="settings-contents">File contents:</label>
+        <textarea class="form-control" id="settings-contents" name="contents">{{
+            contents|e('html_attr')
+        }}</textarea>
+        <button class="btn btn-verydark form-control" type="submit">
+            Update Settings
+        </button>
+        <a class="btn btn-default" href="/admin/settings">Return to Admin Settings</a>
+    </form>
+{% endblock %}

templates/admin/settings-index.twig

@@ -0,0 +1,19 @@
+{% extends "base.twig" %}
+
+{% block main %}
+    <h1>Site Settings</h1>
+    <ul>
+        <li>
+            <a href="/admin/settings/edit?file=admins%2ejson">Administrators</a> &mdash;
+            Add/remove user accounts from the administrator roster.
+        </li>
+        <li>
+            <a href="/admin/settings/edit?file=anthrokit%2ephp">AnthroKit Settings</a> &mdash;
+            Configure AnthroKit (framework plugins used by this software).
+        </li>
+        <li>
+            <a href="/admin/settings/edit?file=settings%2ephp">Global Site Settings</a> &mdash;
+            Edit settings that affect the entire site at the framework level.
+        </li>
+    </ul>
+{% endblock %}