https://github.com/davide-casiraghi/php-responsive-random-quote

A PHP package to show random quotes or the quote of the day.
https://github.com/davide-casiraghi/php-responsive-random-quote

laravel laravel-5-package php quotes

Last synced: 29 days ago
JSON representation

A PHP package to show random quotes or the quote of the day.

• Host: GitHub
• URL: https://github.com/davide-casiraghi/php-responsive-random-quote
• Owner: davide-casiraghi
• License: mit
• Created: 2019-03-04T09:47:05.000Z (almost 6 years ago)
• Default Branch: master
• Last Pushed: 2019-07-08T08:58:09.000Z (over 5 years ago)
• Last Synced: 2024-11-06T21:16:47.301Z (3 months ago)
• Topics: laravel, laravel-5-package, php, quotes
• Language: PHP
• Size: 7.76 MB
• Stars: 1
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE.md

Awesome Lists containing this project

README

        
[![Latest Stable Version](https://img.shields.io/packagist/v/davide-casiraghi/php-responsive-random-quote.svg?style=flat-square)](https://packagist.org/packages/davide-casiraghi/php-responsive-random-quote)

[![StyleCI](https://styleci.io/repos/173717359/shield?style=flat-square)](https://styleci.io/repos/173717359)



[![Quality Score](https://img.shields.io/scrutinizer/g/davide-casiraghi/php-responsive-random-quote.svg?style=flat-square)](https://scrutinizer-ci.com/g/davide-casiraghi/php-responsive-random-quote)

[![Coverage Status](https://scrutinizer-ci.com/g/davide-casiraghi/php-responsive-random-quote/badges/coverage.png?b=master)](https://scrutinizer-ci.com/g/davide-casiraghi/php-responsive-random-quote/)



[![GitHub last commit](https://img.shields.io/github/last-commit/davide-casiraghi/php-responsive-random-quote.svg)](https://github.com/davide-casiraghi/php-responsive-random-quote) 

# Laravel Reponsive Random Quotes

Show a random quote or the quote of the day in your PHP Laravel project.  

The package support multi language trough dimsav/laravel-translatable and mcamara/laravel-localization packages.

## Installation

Require the package using composer:

```bash

composer require davide-casiraghi/php-responsive-random-quote

```

## Publish the files from the service provider

```bash

php artisan vendor:publish --force

```

And then pick the number of the related service provider.

## Create the DB tables

```bash

php artisan migrate

```

This will create in your databases two new tables: **quotes** and **quote_translations**.  

## Import the _responsive-quote.scss file in /resources/scss/app.scss

```php

@import 'vendor/responsive-quotes/responsive-quote';   

```

and then run in console:

```npm run dev```   

## Usage

### Add quotes to the database table

The package adds in the application in which it is installed the route **/php-responsive-quote/**  

From this route it's possible to add, edit and remove the quotes and their translations.

### Show a random quote

```php

use DavideCasiraghi\PhpResponsiveRandomQuote\QuoteFactory;

$quote = PhpResponsiveQuote::getRandomQuote();

```

Then in any blade file is possible include the view like this:

```php

@include('vendor.responsive-quotes.show-random-quote', [

   'quoteAuthor' => $quote['author'],

   'quoteText' => $quote['text'],

])

```

## Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Please make sure to update tests as appropriate.

### Testing

You can run unit tests checking the code coverage using this command.

``` bash

./vendor/bin/phpunit --coverage-html=html

```

So you can find the reports about the code coverage in this file **/html/index.html**

## License

[MIT](./LICENSE.md)