Laravel Events
A Laravel 4 package to add events listings to a site, (*1)
Events have
- start/end datetimes, and a text based date field for things like "Fri, 21st Feb. 9pm 'til late!"
- title, summary and content fields
- main image or YouTube Video
- map showing location (control the marker centre, map centre, map zoom and marker title)
- link to more info about the event (control the URL and the link text)
- separate page title, meta description and keywords fields, also a slug field which is automatically generated from the title
- Draft/Approved status
- published date for future publishing
- In RSS? and Is Sticky? fields
The package comes with
- Optional routes file with configurable URL prefix, or you can choose to use your own routes
- EventsController with actions for listing events, viewing individual events and an RSS feed of events.
- A migration for the events table, and a faker seed to populate it.
- The Event model for interacting with Event data
- Views and partials for showing the event listings and event details.
Installation
Add the following to you composer.json file (Recommend swapping "dev-master" for the latest release), (*2)
"fbf/laravel-events": "dev-master"
Run, (*3)
composer update
Add the following to app/config/app.php, (*4)
'Fbf\LaravelEvents\LaravelEventsServiceProvider'
Run the package migration, (*5)
php artisan migrate --package=fbf/laravel-events
Publish the config, (*6)
php artisan config:publish fbf/laravel-events
Optionally tweak the settings in the many config files for your app, (*7)
Optionally copy the administrator config file (src/config/administrator/events.php) to your administrator model config directory., (*8)
Create the relevant image upload directories that you specify in your config, e.g., (*9)
public/uploads/packages/fbf/laravel-events/main_image/original
public/uploads/packages/fbf/laravel-events/main_image/thumbnail
public/uploads/packages/fbf/laravel-events/main_image/resized
Faker seed
The package comes with a seed that can populate the table with a whole bunch of sample events. There are some configuration options for the seeder in the seed config file. To run it:, (*10)
php artisan db:seed --class="Fbf\LaravelEvents\FakeEventsSeeder"
Configuration
See the many configuration options in the files in the config directory, (*11)
Administrator
You can use the excellent Laravel Administrator package by frozennode to administer your data., (*12)
http://administrator.frozennode.com/docs/installation, (*13)
A ready-to-use model config file for the Event model (events.php) is provided in the src/config/administrator directory of the package, which you can copy into the app/config/administrator directory (or whatever you set as the model_config_path in the administrator config file)., (*14)
Usage
The package should work out the box (provided you have a master blade layout file, since the out-of-the-box views extend this)
but if you want to add other content to the pages, such as your own header, logo, navigation, sidebar etc, you'll want to
override the views provided., (*15)
The package views declare several sections that you may want to yield in your app/views/layouts/master.blade.php file, e.g.:, (*16)
<!DOCTYPE html>
<html>
<head>
<title>@yield('title')</title>
<meta name="description" content="@yield('meta_description')">
<meta name="keywords" content="@yield('meta_keywords')">
</head>
<body>
<div class="content">
@yield('content')
</div>
</body>
</html>
The package's views are actually really simple, and most of the presentation is done in partials. This is deliberate so you
can override the package's views in your own app, so you can include your own chrome, navigation and sidebars etc, yet
you can also still make use of the partials provided, if you want to., (*17)
To override any view in your own app, just create the following directories and copy the file from the package into it, then hack away
* app/views/packages/fbf/laravel-events/events
* app/views/packages/fbf/laravel-events/partials, (*18)
Extending
You can extend the model to add more fields, relations and even filter event listings by a relationship., (*19)
See the extending section in the readme on http://github.com/FbF/Laravel-Blog as it works the same way., (*20)
Wallogit.com
