Skip to content

mmmmlemon/larablogger-cms

Repository files navigation

A Laravel based CMS for blogging


What is this?

Larablogger is a CMS based on PHP framework Laravel for creating and maintaining personal blogs. The key feature is easy to use file uploader and media browser that allows you to share videos and photos on your personal wen-

Key features

  • Post managment system. You can show or hide posts, pin or unpin posts.
  • Advanced media managment system. You can attach videos and photos to your blog posts. You can set thumbnails and upload subtitles to your videos (just like on YouTube).
  • You can manage categories and change design of your site.
  • Feedback system.

The list of features will expand as the development goes on.


Installation

To run the CMS on your local machine do the following steps (you will need PHP 7.2 or above and MySQL or any other DBMS supported by Laravel installed on your computer).

  1. Create the ".env" file using the ".env.example" in the root folder.
  2. Create an empty database in your preferred DBMS (in our case that would be "videoblog" database in MySQL) and write a connection in your ".env" file like this
  3. DB_CONNECTION=mysql

    DB_HOST=127.0.0.1

    DB_PORT=3306

    DB_DATABASE=videoblog

    DB_USERNAME=*database_username*

    DB_PASSWORD=*database_password*

  4. Install Composer and run "composer update" command in your project derictory. That will install all of the project dependencies.
  5. Open AppServiceProvider.php file that is in app/Providers folder and uncomment the boot function.
  6. Run "php artisan migrate" command, that will fill your database with tables and predefined data.
  7. Run "php artisan storage:link" command, that will enable the file storage for your web-site.
  8. Run "php artisan key:generate" command, that will generate the encryption key for your web-site.
  9. Run "php artisan config:cache" command, to clear cache (sometimes the encryption key won't be recognized until you clear the cache) .
  10. Run "php artisan serve" to start the server on your local machine.
  11. Open "127.0.0.1/register" url in your browser and register a user. The very first registered user gets Super Admin rights.

To run the CMS on a hosting or a dedicated server you need to do these steps.

  1. Upload the project to the root folder of your web-site.
  2. Repeat the steps 1-7 from the instruction above.
  3. If your index folder is public_html, follow steps in this instruction to change the index folder from public to public_html.
  4. Register a user through "your-web-site.com/register" url to create a Super Admin user.

Feedback system

To enable the Feedback system follow these steps.

  1. Open the control panel on your web-site and set up "Contact e-mail" and "Sender e-mail" field in Settings. "Contact e-mail" is an e-mail that feedback messages will be sent to. "Sender e-mail" is an e-mail that will be used as a sender.
  2. Open the ".env" file and add info about your smtp server like this.
  3. MAIL_MAILER=smtp

    MAIL_HOST=smtp.my-email-server.com

    MAIL_PORT=2525

    MAIL_USERNAME=my-sender-email@mail.com

    MAIL_PASSWORD=my-sender-email-password

    MAIL_ENCRYPTION=tls

  4. Use "php artisan config:cache" command in case the config doesn't update.

Libraries used in development of this project


This project is free to use.