codwelt / laravel-blog
Blog para laravel
Requires
- php: >= 7.1
- ext-bcmath: *
- ext-dom: *
- ext-gd: *
- ext-gmp: *
- artesaos/seotools: ~0.16
- bitpress/blade-extensions: ^1.0
- codwelt/helpersman: ~2.1
- intervention/image: ^2.4
- justinrainbow/json-schema: ~5.2
- laravel/framework: ~5.6 | ~6.0
- laravelium/sitemap: ~3.0 | ~4.0 | ~5.0 | ~6.0
- sebastian/diff: ^3.0
- spatie/laravel-robots-middleware: ^1.0
- vinkla/hashids: ~4.0 | ~5.0 | ~6.0 | ~7.0
Requires (Dev)
- ext-pdo_sqlite: *
- doctrine/dbal: ^2.8
- orchestra/testbench: ~3.6 | ~4.0
- orchestra/testbench-browser-kit: ~3.6 | ~4.0
- symfony/thanks: ^1.0
README
Ejecutar en la consola dentro en la raiz del proyecto el comando:
$ composer require codwelt/laravel-blog
o añadiendo directamente el el archivo composer.json
{
"require": {
"codwelt/laravel-blog": "~2.0"
}
}
Puede añadir en su archivo composer.json en script el evento post-update-cmd y endonde puede añadir el comando update del post para que se ejecute cada vez que se actualicen los paquetes.
"post-update-cmd":[ "@php artisan codwelt_blog:update" ]
Ejecutar dentro del proyecto el comando, esto realizara la instalacion del blog, lo que es las migraciones, publicacion de archivos de configuracion
$ php artisan codwelt_blog:install
Configuracion
Creadores de post
Para que se puedan crear los post es necesario asociarlos a un modelo que seria el autor del post, por tal motivo es necesario indicar cual es el modelo de su proyecto quien creara los post.
Para ello en el el archivo llamado blogCodwelt.php en la ruta config/blogCodwelt.php estara un array como este
'creatorPost' => [ 'model' => App\User::class, 'columnOfRelation' => 'id' ],
en el key llamado model por defecto esta la ruta del modelo usuario pero si este no sera en su proyecto el modelo que creara los post reemplaze el de usuario y escriba la ruta de la clase del modelo recuerde que debe terminar en ::class.
El key llamado columnOfRelation debe indicar la columna con la cual se relacionara los post con el modelo; por defecto es el id de la tabla que es la llave primaria de la tabla usuarios, asi que si su modelo en la tabla tiene una llave primaria diferente debe cambiarla.
Para finalizar en su modelo creados de post debe usar el trait llamado CreatorOfPosts que su ruta seria CodWelt\Blog\Operations\Core\Traits\CreatorOfPosts.
Adicionalmente el trait tiene un metodo abstracto llamado getName el cual debe implentar en el modelo y el cual debe retornar el nombre que se mostrara para
el creador del post, que para nuestro caso representa el mismo fillable name del modelo
<?php
namespace App;
use Codwelt\Blog\Operations\Core\Traits\CreatorOfPosts;
use Illuminate\Foundation\Auth\User as Authenticatable;
class User extends Authenticatable
{
use CreatorOfPosts;
/**
* The attributes that are mass assignable.
*
* @var array
*/
protected $fillable = ['id', 'name', 'email', 'password', 'cargo', 'imgperfil', 'telefono', 'emailsecundario', 'activo'];
/**
* Debe retornar el nombre de quien crea el post
* @return string
*/
public function getNameModel()
{
return $this->name;
}
}
Comentadores del post
Los comentarios del post pueden ser realizados por usuarios anonimos o por usuarios registrado con un modelo dentro de laravel, si desea que los comentario aparescan con el nombre del usuario que comento debe especificar en el archivo de configuracion el modelo y la columna que realacion el comentario con el usuario
'commentatorPost' => [ 'model' => App\User::class, 'columnOfRelation' => 'id' ],
en el key llamado model por defecto esta la ruta del modelo usuario pero si este no sera en su proyecto el modelo que creara los post reemplaze el de usuario y escriba la ruta de la clase del modelo recuerde que debe terminar en ::class.
El key llamado columnOfRelation debe indicar la columna con la cual se relacionara los post con el modelo; por defecto es el id de la tabla que es la llave primaria de la tabla usuarios, asi que si su modelo en la tabla tiene una llave primaria diferente debe cambiarla.
Para finalizar en su modelo creados de post debe usar el trait llamado CommentatorOfPosts que su ruta seria CodWelt\Blog\Operations\Core\Traits\CommentatorOfPosts.
Adicionalmente el trait tiene un metodo abstracto llamado getNameModel el cual debe implentar en el modelo y el cual debe retornar el nombre que se mostrara para
el creador del post, que para nuestro caso representa el mismo fillable name del modelo, adicioanlmente tambien se requiere implementar el metodo getEmailModel el cual debe devolver
el correo electronico del usuario y getUrlImageProfile que debe devolver la url de la imagen del perfil del usuario
<?php
namespace App;
use Codwelt\Blog\Operations\Core\Traits\CommentatorOfPosts;
use Illuminate\Foundation\Auth\User as Authenticatable;
class User extends Authenticatable
{
use CommentatorOfPosts;
/**
* The attributes that are mass assignable.
*
* @var array
*/
protected $fillable = ['id', 'name', 'email', 'password', 'cargo', 'imgperfil', 'telefono', 'emailsecundario', 'activo'];
/**
* Debe retornar el nombre de quien crea el post
* @return string
*/
public function getNameModel()
{
return $this->name;
}
/**
* Correo electronico que se mostrara en los comentarios
* @return string
*/
public function getEmailModel()
{
return $this->email;
}
/**
* Debe retornar la url de la foto de perfil del usuario, si se retorna nulo se asigna una foto por defecto
* @return mixed
*/
public function getUrlImageProfile(){
$this->url_profile;
}
}