compatible with laravel 6.x

Author: samberrry

LICENSE.txt

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2017-2019 WebDevEtc.
+Copyright (c) 2018 WebDevEtc.
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

README.md

@@ -1,20 +1,19 @@
-Package is in a rewrite (should be done by xmas 2019). Proper tests coming, unfortunately work has taken up a lot of my time since I first added this package, and I don't have time to get back to it and maintain it properly. The rewrite (which is just on the master branch...) has much better coding standards, proper unit/integration tests are intended to be added soon. The current versions on Packagist are on a different branch. I thought the rewrite would be a bit quicker! 
+# August 2019 -
 
-Some older features will be stripped out. The next version will be a breaking change, but the code will be more maintainable. This package was originally (back in version 1) not really expecting to get any public use. The new version will handle more use cases easier.
+I am currently rewriting a lot of the code base (better quality, better coding standards, etc). Laravel 5.8 is supported on the old version (3.x) - please see packagist. I will release v4 soon.
 
 # WebDevEtc BlogEtc
 ## Easy to install Laravel Package for adding a full blog (with admin backend) to your Laravel app
-
-#### 5 minutes to install! Quick and easy!
-
-[![StyleCI](https://github.styleci.io/repos/144829997/shield?branch=master)](https://github.styleci.io/repos/144829997)
-[![Build Status](https://travis-ci.org/WebDevEtc/BlogEtc.svg?branch=master)](https://travis-ci.org/WebDevEtc/BlogEtc)
+### 5 minutes to install! Quick and easy!
 
 ## Introduction
 
 This is [WebDevEtc's](https://webdevetc.com/) BlogEtc package. It has everything you need to quickly and easily add a blog to your laravel app.
 
-#### For the full installation guide please visit [the Laravel Blog Etc install guide here](https://webdevetc.com/laravel/packages/blogetc-blog-system-for-your-laravel-app/help-documentation/laravel-blog-package-blogetc#install_guide)
+
+## FOR 5 MINUTE INSTALLATION GUIDE (with video guide), PLEASE VISIT [THE INSTALL GUIDE HERE](https://webdevetc.com/laravel/packages/blogetc-blog-system-for-your-laravel-app/help-documentation/laravel-blog-package-blogetc#install_guide)
+
+[Install guide](https://webdevetc.com/laravel/packages/blogetc-blog-system-for-your-laravel-app/help-documentation/laravel-blog-package-blogetc#install_guide) • [Packagist](https://packagist.org/packages/webdevetc/blogetc) << MAKE SURE YOU FOLLOW THE INSTURCTIONS. They're simple, but must be followed.
 
 ## Features
 
@@ -79,6 +78,8 @@ This is [WebDevEtc's](https://webdevetc.com/) BlogEtc package. It has everything
 
 2) if `use_custom_view_files` is enabled in the config (which it is by default), it means that any post with a custom view file set (details in the docs) can include any file within `/resources/views/custom_blog_posts`, which blade will execute. This package gives no method to edit any file within that directory though.
 
+
+
 ## How to install BlogEtc to your laravel app
 
 Please see our [BlogEtc Laravel Blog Package Documentation/install guide](https://webdevetc.com/laravel/packages/blogetc-blog-system-for-your-laravel-app/help-documentation/laravel-blog-package-blogetc#install_guide) for install instructions. (It is very simple - done via composer/artisan commands, plus adding one method to your \App\User model (`canManageBlogEtcPosts()` which should return `true` if this user can manage the blog).
@@ -112,6 +113,27 @@ There is a built in captcha (anti spam comment) system built in, which will be e
 
   Please see [our Captcha docs](https://webdevetc.com/laravel/packages/blogetc-blog-system-for-your-laravel-app/help-documentation/laravel-blog-package-blogetc#captcha) for  more details.
 
+## TODO
+
+This is a list of features or things that I want to eventually get round to adding
+
+- Better UI for uploading images/viewing uploaded images
+- Link uploaded images to blog post. At the moment they are not related.
+- Allow users to remove a featured image from a blog post.
+- Option to use HTMLPurifier to sanatise output.
+- Better options for assigning post authors (currently it just assigns the currently logged in user). However, if site has 10,000+ users do we really want an UI interface for this? The alternative is to add something like a a is_admin field to the `users` table and only show admin users.
+- Possibly add tags (we already have categories) but I am not sure how useful they really are, given that we already have categories.
+- Pagination for comments on view single post? At the moment we limit it to a high number (default in config is 5000).
+- RSS feed: shows from full (stripped tags) ->html of blog post (although has a setTextLimit() on it) - need to trim this, and if it uses custom view files then it should render that (without html).
+- Email notification to admin when new comment is added
+- RSS to use generate_introduction() for its contents.
+
+
+## Recent changes:
+
+1) Added full text search and search views. You have to enable it in the config file (see latest config file)
+2) Need more than the 3 default image sizes? Add more in the config/blogetc.php file, add the database column for it and it'll work!
+
 ## Having problems, something is not working?
 
 *Image upload errors?*
@@ -123,18 +145,21 @@ Try adding this to config/app.php:
 - Also make sure that /tmp is writable. If you have open_basedir enabled, be sure to add :/tmp to its value.
 - Ensure that /public/blog_images (or whatever directory you set it to in the config) is writable by the server
 - You might need to set a higher memory limit, or upload smaller image files. This will depend on your server. I've used it to upload huge (10mb+) jpg images without problem, once the server was set up correctly to handle larger file uploads.
-- New version of BlogEtc uses the Laravel filesystem to store images. You will probably need to run `php artisan storage:link` to use the images locally. If you are using something such as S3 then you will probably need to change the urls in blade.
+
+
+
 
 ## Version History
 
-- 4.x - Currently work in progress. Will be released end of 2019. For Laravel 6 onwards.
+
+
 - 3.1                   - minor fixes
 - 3.0.3                 - fixed RSS feed cache issue
 - 3.0.2                 - fixed default medium image size (changed to 600x400)
 - 3.0.1                 - replaced all short tags (<?) with full opening ones (<?php)
 - 3.0                   - Added separate functionality for uploading images (and save some meta data in db)
 - 2.1                   - added 'short_description' to db + form, and BlogEtcPost::generate_introduction() method will try and use this to generate intro text.
-- 2.0                   - added full text search (enable it via the config file - it is disabled by default). (removed in future version, will be added again via a different package)
+- 2.0                   - added full text search (enable it via the config file - it is disabled by default).
 - 1.2                   - added WYSIWYG, few smaller changes
 - 1.1.1                 - added basic captcha
 - 1.0.5                 - composer.json changes.
@@ -147,13 +172,6 @@ Try adding this to config/app.php:
 
 Please contact me on the contact from on [WebDev Etc](https://webdevetc.com/) or on [twitter](https://twitter.com/web_dev_etc/) and I'll get back to you asap.
 
-## Upgrading to v6
-
-A lot of the code base was changed for the next version of BlogEtc. I highly recommend you test locally.
 
-Here is what you need to know:
 
-1) Image uploads are now handled by the Laravel filesystem disks. You can use this to upload to services such as S3. By default it will use the 'public' disk, which will require you to run `php artisan storage:link` to create a symblink. Existing images will need to be moved to /storage/app/public/blog_images, and urls will need to be updated (to http://yoursite.com/storage/blog_images/*.jpg). You could also create a symblink to just link /storage/app/public/blog_images to http://yoursite/blog_images.
-2) Many of the internal files have been changed. Most files follow a proper coding style. This should not affect you.
-3) The search feature has been removed (it will get added again in the future).
 

composer.json

@@ -33,7 +33,8 @@
         "cviebrock/eloquent-sluggable": "4.5.*|4.6.*|4.7.*|4.8.*|6.0.*",
         "laravelium/feed": "~2.12.0|~3.0.0|3.1.*|v6.0.*",
         "intervention/image": "2.*",
-        "swisnl/laravel-fulltext": "^0.18.0"
+        "swisnl/laravel-fulltext": "^0.18.0",
+        "laravel/helpers": "^1.2"
     },
     "require-dev": {
         "phpunit/phpunit": "*",

migrations/2018_05_28_224023_create_blog_etc_posts_table.php

@@ -1,38 +1,32 @@
 <?php
 
-use Illuminate\Database\Migrations\Migration;
-use Illuminate\Database\Schema\Blueprint;
 use Illuminate\Support\Facades\Schema;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Database\Migrations\Migration;
 
-/**
- * Class CreateBlogEtcPostsTable.
- */
 class CreateBlogEtcPostsTable extends Migration
 {
     /**
-     * Initial DB table setup for blog etc package.
+     * Run the migrations.
      *
      * @return void
      */
-    public function up(): void
+    public function up()
     {
-        Schema::create('blog_etc_posts', static function (Blueprint $table) {
+        Schema::create('blog_etc_posts', function (Blueprint $table) {
             $table->increments('id');
-            $table->unsignedInteger('user_id')->index()->nullable();
-            $table->string('slug')->unique();
+            $table->unsignedInteger("user_id")->index()->nullable();
+            $table->string("slug")->unique();
 
-            $table->string('title')->nullable()->default('New blog post');
-            $table->string('subtitle')->nullable()->default('');
-            $table->text('meta_desc')->nullable();
-            $table->mediumText('post_body')->nullable();
+            $table->string("title")->nullable()->default("New blog post");
+            $table->string("subtitle")->nullable()->default("");
+            $table->text("meta_desc")->nullable();
+            $table->mediumText("post_body")->nullable();
 
-            $table->string('use_view_file')
-                ->nullable()
-                ->comment('If not null, this should refer to a blade file in /views/');
+            $table->string("use_view_file")->nullable()->comment("should refer to a blade file in /views/");
 
-            $table->dateTime('posted_at')->index()->nullable()
-                ->comment('Public posted at time, if this is in future then it wont appear yet');
-            $table->boolean('is_published')->default(true);
+            $table->dateTime("posted_at")->index()->nullable()->comment("Public posted at time, if this is in future then it wont appear yet");
+            $table->boolean("is_published")->default(true);
 
             $table->string('image_large')->nullable();
             $table->string('image_medium')->nullable();
@@ -41,55 +35,56 @@ public function up(): void
             $table->timestamps();
         });
 
-        Schema::create('blog_etc_categories', static function (Blueprint $table) {
+        Schema::create('blog_etc_categories', function (Blueprint $table) {
             $table->increments('id');
 
-            $table->string('category_name')->nullable();
-            $table->string('slug')->unique();
-            $table->mediumText('category_description')->nullable();
+            $table->string("category_name")->nullable();
+            $table->string("slug")->unique();
+            $table->mediumText("category_description")->nullable();
 
-            $table->unsignedInteger('created_by')->nullable()->index()->comment('user id');
+            $table->unsignedInteger("created_by")->nullable()->index()->comment("user id");
 
             $table->timestamps();
         });
 
-        // linking table:
-        Schema::create('blog_etc_post_categories', static function (Blueprint $table) {
+        Schema::create('blog_etc_post_categories', function (Blueprint $table) {
             $table->increments('id');
 
-            $table->unsignedInteger('blog_etc_post_id')->index();
-            $table->foreign('blog_etc_post_id')->references('id')->on('blog_etc_posts')->onDelete('cascade');
+            $table->unsignedInteger("blog_etc_post_id")->index();
+            $table->foreign('blog_etc_post_id')->references('id')->on('blog_etc_posts')->onDelete("cascade");
 
-            $table->unsignedInteger('blog_etc_category_id')->index();
-            $table->foreign('blog_etc_category_id')->references('id')->on('blog_etc_categories')->onDelete('cascade');
+            $table->unsignedInteger("blog_etc_category_id")->index();
+            $table->foreign('blog_etc_category_id')->references('id')->on('blog_etc_categories')->onDelete("cascade");
         });
 
-        Schema::create('blog_etc_comments', static function (Blueprint $table) {
+
+        Schema::create('blog_etc_comments', function (Blueprint $table) {
             $table->increments('id');
 
-            $table->unsignedInteger('blog_etc_post_id')->index();
-            $table->foreign('blog_etc_post_id')->references('id')->on('blog_etc_posts')->onDelete('cascade');
-            $table->unsignedInteger('user_id')->nullable()->index()->comment('if user was logged in');
+            $table->unsignedInteger("blog_etc_post_id")->index();
+            $table->foreign('blog_etc_post_id')->references('id')->on('blog_etc_posts')->onDelete("cascade");
+            $table->unsignedInteger("user_id")->nullable()->index()->comment("if user was logged in");
 
-            $table->string('ip')->nullable()->comment('if enabled in the config file');
-            $table->string('author_name')->nullable()->comment('if not logged in');
+            $table->string("ip")->nullable()->comment("if enabled in the config file");
+            $table->string("author_name")->nullable()->comment("if not logged in");
 
-            $table->text('comment')->comment('the comment body');
+            $table->text("comment")->comment("the comment body");
 
-            $table->boolean('approved')->default(true);
+            $table->boolean("approved")->default(true);
 
             $table->timestamps();
         });
+
+
     }
 
     /**
      * Reverse the migrations.
      *
      * @return void
      */
-    public function down(): void
+    public function down()
     {
-        Schema::dropIfExists('blog_etc_comments');
         Schema::dropIfExists('blog_etc_post_categories');
         Schema::dropIfExists('blog_etc_categories');
         Schema::dropIfExists('blog_etc_posts');

migrations/2018_09_16_224023_add_author_and_url_blog_etc_posts_table.php

@@ -1,37 +1,37 @@
 <?php
 
-use Illuminate\Database\Migrations\Migration;
-use Illuminate\Database\Schema\Blueprint;
 use Illuminate\Support\Facades\Schema;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Database\Migrations\Migration;
 
-/**
- * Class AddAuthorAndUrlBlogEtcPostsTable.
- */
 class AddAuthorAndUrlBlogEtcPostsTable extends Migration
 {
     /**
-     * Add author_email and author_website columns to Blog Etc comments table.
+     * Run the migrations.
      *
      * @return void
      */
-    public function up(): void
+    public function up()
     {
-        Schema::table('blog_etc_comments', static function (Blueprint $table) {
-            $table->string('author_email')->nullable();
-            $table->string('author_website')->nullable();
+        Schema::table('blog_etc_comments', function (Blueprint $table) {
+            $table->string("author_email")->nullable();
+            $table->string("author_website")->nullable();
         });
+
     }
 
     /**
      * Reverse the migrations.
      *
      * @return void
      */
-    public function down(): void
+    public function down()
     {
-        Schema::table('blog_etc_comments', static function (Blueprint $table) {
-            $table->dropColumn('author_email');
-            $table->dropColumn('author_website');
+
+        Schema::table('blog_etc_comments', function (Blueprint $table) {
+            $table->dropColumn("author_email");
+            $table->dropColumn("author_website");
         });
     }
 }
+

migrations/2018_09_26_085711_add_short_desc_textrea_to_blog_etc.php

@@ -1,37 +1,34 @@
 <?php
 
-use Illuminate\Database\Migrations\Migration;
-use Illuminate\Database\Schema\Blueprint;
 use Illuminate\Support\Facades\Schema;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Database\Migrations\Migration;
 
-// (ignore typo! Don't want to change in case it breaks some people's migrations!)
-
-/**
- * Class AddShortDescTextreaToBlogEtc.
- */
 class AddShortDescTextreaToBlogEtc extends Migration
 {
     /**
-     * Create the DB table changes to add TEXT short_description column.
+     * Run the migrations.
      *
      * @return void
      */
-    public function up(): void
+    public function up()
     {
-        Schema::table('blog_etc_posts', static function (Blueprint $table) {
-            $table->text('short_description')->nullable();
+        Schema::table('blog_etc_posts', function (Blueprint $table) {
+            $table->text("short_description")->nullable();
         });
+
     }
 
     /**
      * Reverse the migrations.
      *
      * @return void
      */
-    public function down(): void
+    public function down()
     {
-        Schema::table('blog_etc_posts', static function (Blueprint $table) {
-            $table->dropColumn('short_description');
+
+        Schema::table('blog_etc_posts', function (Blueprint $table) {
+            $table->dropColumn("short_description");
         });
     }
 }