README

Extras 是一个小的 Laravel 包，其中包含一些常用的组件（函数），这些组件通常大多数应用程序都需要，但并不一定包含在 Laravel 基础安装中。

• 社交登录
• 消息（邮件）
• 地图（谷歌）
• 用于动态图像的 Glide
• 组件（登录、注册、警报、联系...）

即将推出

• Toast 警报
• 通知
• 推送通知
• 备份

阅读文档

安装

通过 Composer

$ composer require shawnsandy/extras dev-master

Laravel 5.4 及以下

$ composer require shawnsandy/extras

所需包

composer require zondicons/blade-bridge thujohn/twitter spatie/laravel-collection-macros rap2hpoutre/laravel-log-viewer plank/laravel-mediable mews/purifier league/glide-laravel laravelcollective/remote laravelcollective/html laravel/socialite laracasts/utilities laracasts/generators laracasts/flash illuminate/support illuminate/http illuminate/contracts greggilbert/recaptcha doctrine/dbal brotzka/laravel-dotenv-editor barryvdh/laravel-ide-helper albertcht/invisible-recaptcha abraham/twitteroauth

打开 config\app.php 并添加以下内容

• 服务提供者数组

Laravel 发现包功能或 Extras 服务提供者一次性自动加载以下包所需的服务提供者/外观。

• 'davestewart\sketchpad\SketchpadServiceProvider'
• 'Collective\Remote\RemoteServiceProvider'
• 'Collective\Html\HtmlServiceProvider'
• 'Mews\Purifier\PurifierServiceProvider'
• 'Thujohn\Twitter\TwitterServiceProvider'
• 'Brotzka\DotenvEditor\DotenvEditorServiceProvider'
• 'Laravel\Socialite\SocialiteServiceProvider'
• ...

'providers' => [
ShawnSandy\Extras\ExtrasServiceProvider::class,
]

或单独加载它们 :(

'providers' => [

    ShawnSandy\Extras\ExtrasProvider::class,
    // --- packages -----
    Thujohn\Twitter\TwitterServiceProvider::class,
    Collective\Html\HtmlServiceProvider::class,
    davestewart\sketchpad\SketchpadServiceProvider'
    Collective\Remote\RemoteServiceProvider'
    Collective\Html\HtmlServiceProvider'
    Mews\Purifier\PurifierServiceProvider'
    Thujohn\Twitter\TwitterServiceProvider'
    Brotzka\DotenvEditor\DotenvEditorServiceProvider'
    Laravel\Socialite\SocialiteServiceProvider'

    // ###
]

• 别名数组

    'aliases' => [

    'Form' => Collective\Html\FormFacade::class,
    'Html' => Collective\Html\HtmlFacade::class,
    'Extras' => \ShawnSandy\Extras\ExtrasFacade::class,
    'Gmap' => \ShawnSandy\Extras\Apps\Maps\MapsFacade::class,
    "Twitter" => \Thujohn\Twitter\Facades\Twitter::class,

   // ###
    ]

路由

Route::group(['prefix' => "extras"], function () {
    Extras::routes();
});

用法

自定义错误页面

  if (env("APP_DEBUG") == false && env("APP_ENV") === "production"):

            return app(SystemErrors::class)->renderErrors($request, $exception);

  endif;

GMAPS（谷歌地图）组件

{{ Html::extrasMap(
    "1600 Pennsylvania Ave NW, Washington, DC 20500", //address
    ["height" => '680px'], // inline style
    ['zoom' => 17, 'scroll' => 'true' ] // options map-zoom / scroll
    )
    }}

Socialite 登录

 {{ Html::networkLogin(

     "Connect Via Social Media",  // title
     ["facebook", "twitter"] // providers (facebook, twitter, linkedin, github)

     ) }}

Laravel 登录组件显示登录表单

{{ Html::extrasLogin("Login Title Here") }}

使用 Glide 的动态图像

输出图像的完整路径 <img src="path/to/image?w=400 ?>

// from public/img
{{ Html::extrasImg("bg/01.jpg?w=500", ["class" => "img-circle", "alt" => "Glide image"]) }}

// from your storage directory
{{ Html::extrasImg("photo1.jpg?w=500", ["class" => "img-responsive", "alt" => "Glide image"], "/extras/img/") }}

SVG 图标_

Material 图标

 {{ Html::materialIcon("material-add-circle") }

Entypo 图标

 {{ Html::entypoIcon("entypo-adjust") }}

变更日志

请参阅变更日志以获取更多关于最近更改的信息。

测试

// $ composer test

贡献

请参阅贡献和行为准则以获取详细信息。

安全

如果您发现任何安全问题，请通过电子邮件shawnsandy04@gmail.com报告，而不是使用问题跟踪器。

致谢

• Shawn Sandy
• [所有贡献者][link-contributors]

许可证

MIT 许可证（MIT）。请参阅许可证文件以获取更多信息。