FEATURE: add customizable settings for create/edit/overview of content pages

app/Http/Controllers/Admin/Contents/CreateNewContent.php

@@ -17,6 +17,13 @@ use Modules\Categories\Entities\Category;
 use Pingpong\Modules\Facades\Module as ModuleInstance;
 use Symfony\Component\HttpKernel\Exception\NotFoundHttpException;
 
+/**
+ * Class CreateNewContent
+ *
+ * Controller for creating new content page.
+ *
+ * @package App\Http\Controllers\Admin\Contents
+ */
 class CreateNewContent extends Controller
 {
     /**
@@ -28,6 +35,14 @@ class CreateNewContent extends Controller
      */
     private $content;
 
+    /**
+     * CreateNewContent constructor.
+     *
+     * Sets File and Content models into class variables
+     *
+     * @param File    $file
+     * @param Content $content
+     */
     public function __construct(File $file, Content $content)
     {
         parent::__construct();
@@ -47,12 +62,19 @@ class CreateNewContent extends Controller
         $module = Module::findOrFail($moduleId);
         $statuses = ContentStatuses::getWithTranslations();
 
+        // set default page title
+        $pageHeading = trans('admin/contents.new', ['name' => trans($module->name)]);
+        if (is_callable([$module->handler, 'getCreateNewTitle'])) {
+            $pageHeading = call_user_func([$module->handler, 'getCreateNewTitle']);
+        }
+
+        // get list of usable templates
         $templates = Template::where('module_id', $moduleId)
                              ->select(['template_name', 'name', 'description'])
                              ->get();
-        $categoryModule = ModuleInstance::get('categories');
 
         // add categories, if supported
+        $categoryModule = ModuleInstance::get('categories');
         $categories = [];
         if ($module->support_categories && $categoryModule->enabled()) {
             $categories = Category::where('module_id', $moduleId)
@@ -64,6 +86,7 @@ class CreateNewContent extends Controller
 
         // render view
         return view('admin.content.new', [
+            'pageHeading'      => $pageHeading,
             'contentStatuses'  => $statuses,
             'templates'        => $templates,
             'moduleId'         => $moduleId,
@@ -89,7 +112,6 @@ class CreateNewContent extends Controller
      */
     public function postNew(CreateNewContentRequest $request, $moduleId)
     {
-        $page = new Content();
         try {
             $module = Module::findOrFail($moduleId);
         } catch (NotFoundHttpException $e) {
@@ -99,6 +121,10 @@ class CreateNewContent extends Controller
                 ->with('error', trans('admin/contents.invalidModule'));
         }
 
+        // create new page
+        $page = new Content();
+        $page->template = $request->template;
+
         // setup basic info
         $page->user_id = \Auth::user()->id;
         $page->language = LaravelLocalization::getCurrentLocale();
@@ -110,10 +136,10 @@ class CreateNewContent extends Controller
         $page->meta_description = $request->metaDescription;
         $page->content = $request->pageContent;
         $page->status = $request->status;
-        $page->template = $request->template;
         $page->module_handler = $module->handler;
         $page->category_id = (int)$request->category > 0 ? $request->category : null;
 
+        // is any parent page specified?
         if ($request->parentPage) {
             $page->parent_id = $request->parentPage;
         }
@@ -124,12 +150,12 @@ class CreateNewContent extends Controller
         $page->title_photo = $file ? $file['filename'] : null;
 
         // let template to modify request and content page
-
         call_user_func_array([CurrentTemplate::handler(), 'beforeSave'], [&$page, $request]);
 
         // save module-specific stuff
         call_user_func_array([$module->handler, 'createNew'], [&$page, $request]);
 
+        // save content of page before (possible) uploading related files
         $page->save();
 
         // upload files assigned to content page

app/Http/Controllers/Admin/Contents/EditContent.php

@@ -35,6 +35,14 @@ class EditContent extends Controller
      */
     private $file;
 
+    /**
+     * EditContent constructor.
+     *
+     * Load ContentHistory and File into this controller
+     *
+     * @param ContentHistory $history
+     * @param File           $file
+     */
     public function __construct(ContentHistory $history, File $file)
     {
         $this->history = $history;
@@ -61,6 +69,11 @@ class EditContent extends Controller
         $module = Module::where('handler', $page->module_handler)
                         ->firstOrFail();
 
+        $pageHeading = trans('admin/contents.edit', ['name' => e($page->title)]);
+        if (is_callable([$module->handler, 'getCreateNewTitle'])) {
+            $pageHeading = call_user_func([$module->handler, 'getEditTitle'], $page);
+        }
+
         // get all Blade templates for rendering page
         $templates = Template::where('module_id', $module->id)
                              ->select(['template_name', 'name', 'description'])
@@ -83,6 +96,7 @@ class EditContent extends Controller
 
         // render view
         return view('admin.content.edit', [
+            'pageHeading'      => $pageHeading,
             'contentStatuses'  => $statuses,
             'page'             => $page,
             'module'           => $module,