fbf/laravel-events

为网站添加活动列表的Laravel 4包

v0.2.1 2014-03-10 12:42 UTC

This package is not auto-updated.

Last update: 2024-09-14 16:18:50 UTC


README

为网站添加活动列表的Laravel 4包

事件具有

  • 开始/结束日期时间,以及一个基于文本的日期字段,例如 "周五,2月21日晚上9点至深夜!"
  • 标题、摘要和内容字段
  • 主要图片或YouTube视频
  • 显示位置的地图(控制标记中心、地图中心和地图缩放以及标记标题)
  • 有关事件的更多信息链接(控制URL和链接文本)
  • 独立的页面标题、元描述和关键字字段,还有一个自动从标题生成的slug字段
  • 草稿/批准状态
  • 未来发布的发布日期
  • 在RSS?和Is Sticky?字段

该包包括

  • 可选的路由文件,具有可配置的URL前缀,或者您可以选择使用自己的路由
  • 具有列出事件、查看单个事件和事件RSS源的操作的EventsController
  • 事件表迁移,以及一个用于填充它的faker种子
  • 用于交互Event数据的Event模型
  • 用于显示事件列表和事件详细信息的视图和部分

安装

将以下内容添加到您的composer.json文件中(建议将"dev-master"替换为最新版本)

"fbf/laravel-events": "dev-master"

运行

composer update

将以下内容添加到app/config/app.php

'Fbf\LaravelEvents\LaravelEventsServiceProvider'

运行包迁移

php artisan migrate --package=fbf/laravel-events

发布配置

php artisan config:publish fbf/laravel-events

可选地调整应用配置文件中的设置

可选地复制管理员配置文件(src/config/administrator/events.php)到您的管理员模型配置目录。

创建您在配置中指定的相关图像上传目录,例如

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种子

该包包含一个可以填充整个示例事件的种子。在种子配置文件中有一些用于播种器的配置选项。要运行它

php artisan db:seed --class="Fbf\LaravelEvents\FakeEventsSeeder"

配置

查看配置目录中的许多配置选项

管理员

您可以使用frozennode的优秀的Laravel Administrator包来管理您的数据。

http://administrator.frozennode.com/docs/installation

在包的src/config/administrator目录中提供了一个用于Event模型的现成模型配置文件(events.php),您可以将其复制到app/config/administrator目录(或管理员配置文件中设置的model_config_path)。

使用方法

该包应该可以直接使用(前提您有一个主blade布局文件,因为默认视图扩展了这个文件),但如果您想在页面中添加其他内容,例如自己的页眉、标志、导航、侧边栏等,您将想要覆盖提供的视图。

该包的视图声明了几个您可能在app/views/layouts/master.blade.php文件中yield的部分,例如

<!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>

该包的视图实际上非常简单,大部分的呈现都在部分中完成。这是故意的,这样您就可以在您的应用中覆盖包的视图,您可以包含自己的chrome、导航和侧边栏等,同时您也可以使用提供的部分,如果您想要的话。

要覆盖您自己的应用中的任何视图,只需创建以下目录,并将文件从包中复制到其中,然后进行修改

  • app/views/packages/fbf/laravel-events/events
  • app/views/packages/fbf/laravel-events/partials

扩展

您可以扩展模型以添加更多字段、关系,甚至通过关系过滤事件列表。

请参阅README中的扩展部分http://github.com/FbF/Laravel-Blog,因为它以相同的方式工作。