Added activity history to to all entities. Fixes #12

.gitignore

@@ -9,4 +9,5 @@ Homestead.yaml
 /public/js
 /public/uploads
 /public/bower
-/storage/images
+/storage/images
+_ide_helper.php

app/Activity.php

@@ -0,0 +1,38 @@
+<?php
+
+namespace Oxbow;
+
+use Illuminate\Database\Eloquent\Model;
+
+/**
+ * @property string key
+ * @property \User user
+ * @property \Entity entity
+ * @property string extra
+ */
+class Activity extends Model
+{
+    public function entity()
+    {
+        if($this->entity_id) {
+            return $this->morphTo('entity')->first();
+        } else {
+            return false;
+        }
+    }
+
+    public function user()
+    {
+        return $this->belongsTo('Oxbow\User');
+    }
+
+    /**
+     * Returns text from the language files, Looks up by using the
+     * activity key.
+     */
+    public function getText()
+    {
+        return trans('activities.' . $this->key);
+    }
+
+}

app/Book.php

@@ -37,4 +37,15 @@ public function children()
         return $pages->sortBy('priority');
     }
 
+    /**
+     * Gets only the most recent activity for this book
+     * @param int $limit
+     * @param int $page
+     * @return mixed
+     */
+    public function recentActivity($limit = 20, $page=0)
+    {
+        return $this->hasMany('Oxbow\Activity')->orderBy('created_at', 'desc')->skip($limit*$page)->take($limit)->get();
+    }
+
 }

app/Entity.php

@@ -34,4 +34,25 @@ public function matches($entity)
     {
         return [get_class($this), $this->id] === [get_class($entity), $entity->id];
     }
+
+    /**
+     * Gets the activity for this entity.
+     * @return \Illuminate\Database\Eloquent\Relations\MorphMany
+     */
+    public function activity()
+    {
+        return $this->morphMany('Oxbow\Activity', 'entity')->orderBy('created_at', 'desc');
+    }
+
+    /**
+     * Gets only the most recent activity
+     * @param int $limit
+     * @param int $page
+     * @return mixed
+     */
+    public function recentActivity($limit = 20, $page=0)
+    {
+        return $this->activity()->skip($limit*$page)->take($limit)->get();
+    }
+
 }

app/Http/Controllers/BookController.php

@@ -2,6 +2,7 @@
 
 namespace Oxbow\Http\Controllers;
 
+use Activity;
 use Illuminate\Http\Request;
 
 use Illuminate\Support\Facades\Auth;
@@ -65,6 +66,7 @@ public function store(Request $request)
         $book->created_by = Auth::user()->id;
         $book->updated_by = Auth::user()->id;
         $book->save();
+        Activity::add($book, 'book_create', $book->id);
         return redirect('/books');
     }
 
@@ -110,6 +112,7 @@ public function update(Request $request, $slug)
         $book->slug = $this->bookRepo->findSuitableSlug($book->name, $book->id);
         $book->updated_by = Auth::user()->id;
         $book->save();
+        Activity::add($book, 'book_update', $book->id);
         return redirect($book->getUrl());
     }
 
@@ -132,7 +135,9 @@ public function showDelete($bookSlug)
      */
     public function destroy($bookSlug)
     {
+        $bookName = $this->bookRepo->getBySlug($bookSlug)->name;
         $this->bookRepo->destroyBySlug($bookSlug);
+        Activity::addMessage('book_delete', 0, $bookName);
         return redirect('/books');
     }
 }

app/Http/Controllers/ChapterController.php

@@ -2,6 +2,7 @@
 
 namespace Oxbow\Http\Controllers;
 
+use Activity;
 use Illuminate\Http\Request;
 
 use Illuminate\Support\Facades\Auth;
@@ -60,6 +61,7 @@ public function store($bookSlug, Request $request)
         $chapter->created_by = Auth::user()->id;
         $chapter->updated_by = Auth::user()->id;
         $book->chapters()->save($chapter);
+        Activity::add($chapter, 'chapter_create', $book->id);
         return redirect($book->getUrl());
     }
 
@@ -107,6 +109,7 @@ public function update(Request $request, $bookSlug, $chapterSlug)
         $chapter->slug = $this->chapterRepo->findSuitableSlug($chapter->name, $book->id, $chapter->id);
         $chapter->updated_by = Auth::user()->id;
         $chapter->save();
+        Activity::add($chapter, 'chapter_update', $book->id);
         return redirect($chapter->getUrl());
     }
 
@@ -134,13 +137,15 @@ public function destroy($bookSlug, $chapterSlug)
     {
         $book = $this->bookRepo->getBySlug($bookSlug);
         $chapter = $this->chapterRepo->getBySlug($chapterSlug, $book->id);
+        $chapterName = $chapter->name;
         if(count($chapter->pages) > 0) {
             foreach($chapter->pages as $page) {
                 $page->chapter_id = 0;
                 $page->save();
             }
         }
         $chapter->delete();
+        Activity::addMessage('chapter_delete', $book->id, $chapterName);
         return redirect($book->getUrl());
     }
 }

app/Http/Controllers/PageController.php

@@ -2,10 +2,10 @@
 
 namespace Oxbow\Http\Controllers;
 
+use Activity;
 use Illuminate\Http\Request;
 
 use Illuminate\Support\Facades\Auth;
-use Illuminate\Support\Str;
 use Oxbow\Http\Requests;
 use Oxbow\Repos\BookRepo;
 use Oxbow\Repos\ChapterRepo;
@@ -76,6 +76,7 @@ public function store(Request $request, $bookSlug)
         $page->updated_by = Auth::user()->id;
         $page->save();
         $this->pageRepo->saveRevision($page);
+        Activity::add($page, 'page_create', $book->id);
         return redirect($page->getUrl());
     }
 
@@ -120,6 +121,7 @@ public function update(Request $request, $bookSlug, $pageSlug)
         $book = $this->bookRepo->getBySlug($bookSlug);
         $page = $this->pageRepo->getBySlug($pageSlug, $book->id);
         $this->pageRepo->updatePage($page, $book->id, $request->all());
+        Activity::add($page, 'page_update', $book->id);
         return redirect($page->getUrl());
     }
 
@@ -187,6 +189,7 @@ public function savePageSort($bookSlug, Request $request)
             }
             $model->save();
         }
+        Activity::add($book, 'book_sort', $book->id);
         return redirect($book->getUrl());
     }
 
@@ -215,6 +218,7 @@ public function destroy($bookSlug, $pageSlug)
     {
         $book = $this->bookRepo->getBySlug($bookSlug);
         $page = $this->pageRepo->getBySlug($pageSlug, $book->id);
+        Activity::addMessage('page_delete', $book->id, $page->name);
         $page->delete();
         return redirect($book->getUrl());
     }
@@ -254,6 +258,7 @@ public function restoreRevision($bookSlug, $pageSlug, $revisionId)
         $page = $this->pageRepo->getBySlug($pageSlug, $book->id);
         $revision = $this->pageRepo->getRevisionById($revisionId);
         $page = $this->pageRepo->updatePage($page, $book->id, $revision->toArray());
+        Activity::add($page, 'page_restore', $book->id);
         return redirect($page->getUrl());
     }
 }

app/Providers/CustomFacadeProvider.php

@@ -0,0 +1,31 @@
+<?php
+
+namespace Oxbow\Providers;
+
+use Illuminate\Support\ServiceProvider;
+use Oxbow\Services\ActivityService;
+
+class CustomFacadeProvider extends ServiceProvider
+{
+    /**
+     * Bootstrap the application services.
+     *
+     * @return void
+     */
+    public function boot()
+    {
+        //
+    }
+
+    /**
+     * Register the application services.
+     *
+     * @return void
+     */
+    public function register()
+    {
+        $this->app->bind('activity', function() {
+            return new ActivityService($this->app->make('Oxbow\Activity'));
+        });
+    }
+}

app/Services/ActivityService.php

@@ -0,0 +1,57 @@
+<?php namespace Oxbow\Services;
+
+use Illuminate\Support\Facades\Auth;
+use Oxbow\Activity;
+use Oxbow\Entity;
+
+class ActivityService
+{
+    protected $activity;
+    protected $user;
+
+    /**
+     * ActivityService constructor.
+     * @param $activity
+     */
+    public function __construct(Activity $activity)
+    {
+        $this->activity = $activity;
+        $this->user = Auth::user();
+    }
+
+
+    /**
+     * Add activity data to database.
+     * @para Entity $entity
+     * @param $activityKey
+     * @param int $bookId
+     */
+    public function add(Entity $entity, $activityKey, $bookId = 0, $extra = false)
+    {
+        $this->activity->user_id = $this->user->id;
+        $this->activity->book_id = $bookId;
+        $this->activity->key = strtolower($activityKey);
+        if($extra !== false) {
+            $this->activity->extra = $extra;
+        }
+        $entity->activity()->save($this->activity);
+    }
+
+    /**
+     * Adds a activity history with a message & without binding to a entitiy.
+     * @param $activityKey
+     * @param int $bookId
+     * @param bool|false $extra
+     */
+    public function addMessage($activityKey, $bookId = 0, $extra = false)
+    {
+        $this->activity->user_id = $this->user->id;
+        $this->activity->book_id = $bookId;
+        $this->activity->key = strtolower($activityKey);
+        if($extra !== false) {
+            $this->activity->extra = $extra;
+        }
+        $this->activity->save();
+    }
+
+}

app/Services/Facades/Activity.php

@@ -0,0 +1,14 @@
+<?php namespace Oxbow\Services\Facades;
+
+
+use Illuminate\Support\Facades\Facade;
+
+class Activity extends Facade
+{
+    /**
+     * Get the registered name of the component.
+     *
+     * @return string
+     */
+    protected static function getFacadeAccessor() { return 'activity'; }
+}

composer.json

@@ -7,7 +7,8 @@
     "require": {
         "php": ">=5.5.9",
         "laravel/framework": "5.1.*",
-        "intervention/image": "^2.3"
+        "intervention/image": "^2.3",
+        "barryvdh/laravel-ide-helper": "^2.1"
     },
     "require-dev": {
         "fzaninotto/faker": "~1.4",