News App Laravel Project

Project Overview

The News App Laravel Project is a comprehensive news management system built using Laravel. This project features both a backend dashboard and a frontend website.

Features

• Dashboard Management:

  • User Management: Manage users with roles (admin, writer).
  • Category Management: Create, edit, and delete categories and subcategories.
  • Post Management: Manage news posts, including creating, editing, and deleting posts.
  • Settings: Adjust dashboard settings for customization.

• Frontend Website:

  • News Display: View news posts published from the dashboard.
  • Responsive Design: Access the website on various devices.
  • Category Navigation: Browse news by categories and subcategories.

Installation

Prerequisites

• PHP 7.0 or higher
• Composer
• Laravel 10.x
• MySQL or other supported database

Steps

1. Clone the Repository:

   git clone https://github.com/abdelrahim3AA/news-app-laravel.git

2. Navigate to Project Directory:

   cd news-app-laravel

3. Install Dependencies:

   composer install

4. Environment Configuration: Copy the example environment file and edit it for your local setup:

   cp .env.example .env

   Update your .env file with the correct database and other environment settings.

5. Generate Application Key:

   php artisan key:generate

6. Run Migrations:

   php artisan migrate

7. Seed the Database (optional): If you want to seed the database with sample data, run:

   php artisan db:seed

8. Serve the Application:

   php artisan serve

   Your application should now be accessible at http://localhost:8000.

Usage

• Admin Dashboard:

  • Access the dashboard at /admin.
  • Use the admin credentials to log in and manage users, categories, and posts.

• Writer Dashboard:

  • Writers can log in and create or edit posts.

• Frontend Website:

  • View news posts at the homepage and browse by categories and subcategories.

Directory Structure

• app/Http/Controllers/: Contains controllers for handling requests.
• app/Models/: Contains Eloquent models for interacting with the database.
• database/migrations/: Contains migration files for database schema.
• resources/views/: Contains Blade templates for the frontend and backend views.
• routes/web.php: Defines the routes for the web application.

Contributing

If you would like to contribute to this project, please follow these steps:

1. Fork the repository.
2. Create a feature branch (git checkout -b feature-branch).
3. Commit your changes (git commit -am 'Add new feature').
4. Push to the branch (git push origin feature-branch).
5. Create a new Pull Request.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

• Laravel for the powerful PHP framework.
• Bootstrap for the responsive front-end framework.
• All contributors for their support and improvements.