Guides: initial implementation

* a guide is a wrapper around an article providing management tools. * administration is limited to the review process. Needs to be expanded. * articles on DB pages are seperate. Editor will be added in the future.
2025-11-29 15:58:16 +08:00 · 2022-03-02 18:19:50 +01:00
parent 33a870ef78
commit b890d6504e
63 changed files with 6734 additions and 338 deletions
--- a/pages/guides.php
+++ b/pages/guides.php
@@ -0,0 +1,100 @@
+<?php
+
+if (!defined('AOWOW_REVISION'))
+    die('illegal access');
+
+
+// menuId ?:Category g_initPath()
+//  tabid 6:Guides   g_initHeader()
+class GuidesPage extends GenericPage
+{
+    use TrListPage;
+
+    protected $type      = Type::Guide;
+    protected $tpl       = 'list-page-generic';
+    protected $path      = [6];
+    protected $tabId     = 6;
+    protected $mode      = CACHE_TYPE_PAGE;
+    protected $validCats = [null, 1, 2, 3, 4, 5, 6, 7, 8, 9];
+
+    private   $myGuides  = false;
+
+    public function __construct($pageCall, $pageParam)
+    {
+        $this->getCategoryFromUrl($pageParam);
+
+        parent::__construct($pageCall, $pageParam);
+
+        if ($pageCall == 'my-guides')
+        {
+            if (!User::$id)
+                $this->error();
+
+            $this->name = Util::ucFirst(Lang::guide('myGuides'));
+            $this->myGuides = true;
+        }
+        else
+            $this->name = Util::ucFirst(Lang::guide('guides'));
+    }
+
+    protected function generateContent()
+    {
+        $hCols = ['patch'];                                 // pointless: display date instead
+        $vCols = [];
+        $xCols = ['$Listview.extraCols.date'];              // ok
+
+        if ($this->myGuides)
+        {
+            $conditions = [['userId', User::$id]];
+            $hCols[] = 'author';
+            $vCols[] = 'status';
+        }
+        else
+        {
+            $conditions = array(
+                ['locale', User::$localeId],
+                ['status', GUIDE_STATUS_ARCHIVED, '!'],     // never archived guides
+                [
+                    'OR',
+                    ['status', GUIDE_STATUS_APPROVED],      // currently approved
+                    ['rev', 0, '>']                         // has previously approved revision
+                ]
+            );
+            if (isset($this->category[0]))
+                $conditions[] = ['category', $this->category];
+        }
+
+        $data = [];
+        $guides = new GuideList($conditions);
+        if (!$guides->error)
+            $data = array_values($guides->getListviewData());
+
+        $tabData = array(
+            'data'        => $data,
+            'name'        => Util::ucFirst(Lang::guide('guides')),
+            'hiddenCols'  => $hCols,
+            'visibleCols' => $vCols,
+            'extraCols'   => $xCols
+        );
+
+        $this->lvTabs[] = [GuideList::$brickFile, $tabData];
+
+        $this->redButtons = [BUTTON_GUIDE_NEW => User::$id && User::canComment()];
+    }
+
+    protected function generateTitle()
+    {
+        array_unshift($this->title, $this->name);
+        if (isset($this->category[0]))
+            array_unshift($this->title, Lang::guide('category', $this->category[0]));
+
+    }
+
+    protected function generatePath()
+    {
+        if (isset($this->category[0]))
+            $this->path[] = $this->category[0];
+    }
+}
+
+?>