category hierarchy feature

Author: samberrry

composer.json

@@ -12,8 +12,7 @@
         "posts",
         "news",
         "update",
-        "webdevetc",
-        "webdev"
+        "hessam-blog"
     ],
     "description": "Simple blog package (with admin panel) for Laravel (6.x and 7.x). Includes all views, controllers, routes and can add a blog to any existing Laravel app. Fully customisable blog (view, urls, and many other options). Includes image uploads and a pretty admin interface to manage your blog. Defaults to /blog but you can change it to anything.",
     "license": "MIT",

migrations/2020_05_27_104123_add_parameters_blog_etc_categories_table.php

@@ -0,0 +1,35 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+class AddParametersBlogEtcCategoriesTable extends Migration
+{
+    /**
+     * Run the migrations.
+     *
+     * @return void
+     */
+    public function up()
+    {
+        Schema::table('blog_etc_categories', function (Blueprint $table) {
+            $table->integer('parent_id')->nullable();
+            $table->integer('lft')->nullable();
+            $table->integer('rgt')->nullable();
+            $table->integer('depth')->nullable();
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     *
+     * @return void
+     */
+    public function down()
+    {
+        Schema::table('blog_etc_categories', function (Blueprint $table) {
+            //
+        });
+    }
+}

src/Baum/Extensions/Eloquent/Collection.php

@@ -0,0 +1,41 @@
+<?php
+namespace WebDevEtc\BlogEtc\Baum\Extensions\Eloquent;
+
+use Illuminate\Database\Eloquent\Collection as BaseCollection;
+
+class Collection extends BaseCollection {
+
+  public function toHierarchy() {
+    $dict = $this->getDictionary();
+
+    // Enforce sorting by $orderColumn setting in WebDevEtc\BlogEtc\Baum\Node instance
+    uasort($dict, function($a, $b){
+        return ($a->getOrder() >= $b->getOrder()) ? 1 : -1;
+    });
+
+    return new BaseCollection($this->hierarchical($dict));
+  }
+
+  protected function hierarchical($result) {
+    foreach($result as $key => $node)
+      $node->setRelation('children', new BaseCollection);
+
+    $nestedKeys = array();
+
+    foreach($result as $key => $node) {
+      $parentKey = $node->getParentId();
+
+      if ( !is_null($parentKey) && array_key_exists($parentKey, $result) ) {
+        $result[$parentKey]->children[] = $node;
+
+        $nestedKeys[] = $node->getKey();
+      }
+    }
+
+    foreach($nestedKeys as $key)
+      unset($result[$key]);
+
+    return $result;
+  }
+
+}

src/Baum/Extensions/Eloquent/Model.php

@@ -0,0 +1,119 @@
+<?php
+namespace WebDevEtc\BlogEtc\Baum\Extensions\Eloquent;
+
+use Illuminate\Database\Eloquent\Model as BaseModel;
+use Illuminate\Database\Eloquent\ModelNotFoundException;
+use Illuminate\Database\Eloquent\SoftDeletingScope;
+use WebDevEtc\BlogEtc\Baum\Extensions\Query\Builder as QueryBuilder;
+
+abstract class Model extends BaseModel {
+
+  /**
+   * Reloads the model from the database.
+   *
+   * @return \Baum\Node
+   *
+   * @throws ModelNotFoundException
+   */
+  public function reload() {
+    if ( $this->exists || ($this->areSoftDeletesEnabled() && $this->trashed()) ) {
+      $fresh = $this->getFreshInstance();
+
+      if ( is_null($fresh) )
+        throw with(new ModelNotFoundException)->setModel(get_called_class());
+
+      $this->setRawAttributes($fresh->getAttributes(), true);
+
+      $this->setRelations($fresh->getRelations());
+
+      $this->exists = $fresh->exists;
+    } else {
+      // Revert changes if model is not persisted
+      $this->attributes = $this->original;
+    }
+
+    return $this;
+  }
+
+  /**
+   * Get the observable event names.
+   *
+   * @return array
+   */
+  public function getObservableEvents() {
+    return array_merge(array('moving', 'moved'), parent::getObservableEvents());
+  }
+
+  /**
+   * Register a moving model event with the dispatcher.
+   *
+   * @param  Closure|string  $callback
+   * @return void
+   */
+  public static function moving($callback, $priority = 0) {
+    static::registerModelEvent('moving', $callback, $priority);
+  }
+
+  /**
+   * Register a moved model event with the dispatcher.
+   *
+   * @param  Closure|string  $callback
+   * @return void
+   */
+  public static function moved($callback, $priority = 0) {
+    static::registerModelEvent('moved', $callback, $priority);
+  }
+
+  /**
+   * Get a new query builder instance for the connection.
+   *
+   * @return \Baum\Extensions\Query\Builder
+   */
+  protected function newBaseQueryBuilder() {
+    $conn = $this->getConnection();
+
+    $grammar = $conn->getQueryGrammar();
+
+    return new QueryBuilder($conn, $grammar, $conn->getPostProcessor());
+  }
+
+  /**
+   * Returns a fresh instance from the database.
+   *
+   * @return \Baum\Node
+   */
+  protected function getFreshInstance() {
+    if ( $this->areSoftDeletesEnabled() )
+      return static::withTrashed()->find($this->getKey());
+
+    return static::find($this->getKey());
+  }
+
+  /**
+   * Returns wether soft delete functionality is enabled on the model or not.
+   *
+   * @return boolean
+   */
+  public function areSoftDeletesEnabled() {
+    // To determine if there's a global soft delete scope defined we must
+    // first determine if there are any, to workaround a non-existent key error.
+    $globalScopes = $this->getGlobalScopes();
+
+    if ( count($globalScopes) === 0 ) return false;
+
+    // Now that we're sure that the calling class has some kind of global scope
+    // we check for the SoftDeletingScope existance
+    return static::hasGlobalScope(new SoftDeletingScope);
+  }
+
+  /**
+   * Static method which returns wether soft delete functionality is enabled
+   * on the model.
+   *
+   * @return boolean
+   */
+  public static function softDeletesEnabled() {
+    return with(new static)->areSoftDeletesEnabled();
+  }
+
+}

src/Baum/Extensions/Query/Builder.php

@@ -0,0 +1,39 @@
+<?php
+
+namespace WebDevEtc\BlogEtc\Baum\Extensions\Query;
+
+use Illuminate\Database\Query\Builder as BaseBuilder;
+
+class Builder extends BaseBuilder {
+
+  /**
+   * Replace the "order by" clause of the current query.
+   *
+   * @param  string  $column
+   * @param  string  $direction
+   * @return \Illuminate\Database\Query\Builder|static
+   */
+  public function reOrderBy($column, $direction = 'asc') {
+    $this->orders = null;
+
+    if ( !is_null($column) ) return $this->orderBy($column, $direction);
+
+    return $this;
+  }
+
+  /**
+   * Execute an aggregate function on the database.
+   *
+   * @param  string  $function
+   * @param  array   $columns
+   * @return mixed
+   */
+  public function aggregate($function, $columns = array('*')) {
+    // Postgres doesn't like ORDER BY when there's no GROUP BY clause
+    if ( !isset($this->groups) )
+      $this->reOrderBy(null);
+
+    return parent::aggregate($function, $columns);
+  }
+
+}