fbf/laravel-places

一个用于向网站添加地点列表的 Laravel 4 包,例如酒吧、餐厅或酒店

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

This package is not auto-updated.

Last update: 2024-09-14 15:06:06 UTC


README

一个用于向网站添加地点列表的 Laravel 4 包,例如酒吧、餐厅或酒店

地点具有

  • 标题、摘要和内容字段
  • 主图片或YouTube视频
  • 显示位置的地图(控制标记中心、地图中心和地图缩放以及标记标题)
  • 更多关于地点的信息的链接(控制URL和链接文本)
  • 单独的页面标题、元描述和关键词字段,还有一个自动从标题生成的slug字段
  • 草稿/批准状态
  • 用于未来发布的发布日期
  • 是否置顶?字段

该包包含

  • 可选的路由文件,具有可配置的URL前缀,或者您可以选择使用自己的路由
  • PlacesController,具有列出地点和查看单个地点的操作
  • 地点表迁移,以及用于填充表的faker种子
  • 用于与地点数据交互的地点模型
  • 用于显示地点列表和地点详情的视图和部分

安装

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

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

运行

composer update

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

'Fbf\LaravelPlaces\LaravelPlacesServiceProvider'

运行包迁移

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

发布配置

php artisan config:publish fbf/laravel-places

可选地调整您应用程序的许多配置文件中的设置

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

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

public/uploads/packages/fbf/laravel-places/main_image/original
public/uploads/packages/fbf/laravel-places/main_image/thumbnail
public/uploads/packages/fbf/laravel-places/main_image/resized

Faker种子

该包包含一个种子,可以将大量示例地点填充到表中。在种子配置文件中有一些关于种子的配置选项。要运行它

php artisan db:seed --class="Fbf\LaravelPlaces\FakePlacesSeeder"

配置

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

管理员

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

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

包中提供了Place模型的现成模型配置文件(places.php),位于包的src/config/administrator目录中,您可以将其复制到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-places/places
  • app/views/packages/fbf/laravel-places/partials

扩展

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

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