README

此软件包提供以下功能：

将Eloquent属性映射到SEO元标签
在lang文件中设置和<description>的模板</li> <li>为应用中的任何模型保存自定义SEO数据</li> </ul> 与以下内容一起工作： <ul> <li>元标签</li> <li>Open Graph</li> <li>Twitter Card</li> </ul> 基于<a href="https://github.com/artesaos/seotools" rel="nofollow noindex noopener external ugc">artesaos/seotools</a>的软件包，可在模板中设置元标签。 <h2 class="heading-element">Postcardware</h2><a id="user-content-postcardware" class="anchor" href="#user-content-postcardware" rel="nofollow noindex noopener external ugc"></a> 您可以使用此软件包（它<a href="https://github.com/mad-web/laravel-seoable/blob/HEAD/LICENSE.md" rel="nofollow noindex noopener external ugc">MIT授权</a>），但如果它进入了您的生产环境，我们非常感谢您从家乡寄给我们一张明信片，说明您正在使用我们的哪个软件包。 <h2 class="heading-element">安装</h2><a id="user-content-installation" class="anchor" href="#user-content-installation" rel="nofollow noindex noopener external ugc"></a> 您可以通过composer安装此软件包 对于Laravel <= 5.4 <pre>composer require mad-web/laravel-seoable:1.0.0</pre> 对于Laravel 5.5 <pre>composer require mad-web/laravel-seoable</pre> 对于Laravel <= 5.4 - 现在在config/app.php文件中添加服务提供者 <pre>'providers' => [ // ... MadWeb\Seoable\SeoableServiceProvider::class, ];</pre> 您可以使用以下命令发布迁移： <pre>$ php artisan vendor:publish --provider="MadWeb\Seoable\SeoableServiceProvider" --tag="migrations"</pre> 您可以使用以下命令发布配置文件： <pre>$ php artisan vendor:publish --provider="MadWeb\Seoable\SeoableServiceProvider" --tag="config"</pre> 这是发布的config/laravel-seoable.php配置文件的内容 <pre>return [ /* |-------------------------------------------------------------------------- | Seo Data Table |-------------------------------------------------------------------------- | | You can customize seo data storing table for your models */ 'seo_data_table' => 'seo_data', /* |-------------------------------------------------------------------------- | Seo Data Templates Path |-------------------------------------------------------------------------- | | Path to lang file where you can set property template | | Supported properties: "title", "description" */ 'templates_path' => 'seoable::seo', /* |-------------------------------------------------------------------------- | Seo Data Model |-------------------------------------------------------------------------- | | Model name for seo data table */ 'model' => \MadWeb\Seoable\Models\SeoData::class ];</pre> 要设置<title>和<description>元标签的模板，您可以通过以下方式发布lang文件： <pre>$ php artisan vendor:publish --provider="MadWeb\Seoable\SeoableServiceProvider" --tag="lang"</pre> 或者在<code>templates_path</code>配置属性中设置自己的模板 <pre>/* |-------------------------------------------------------------------------- | Seo Data Templates Path |-------------------------------------------------------------------------- | | Path to lang file where you can set property template | | Supported properties: "title", "description" */ 'templates_path' => 'seoable::seo',</pre> <h2 class="heading-element">使用</h2><a id="user-content-usage" class="anchor" href="#user-content-usage" rel="nofollow noindex noopener external ugc"></a> 下一步，您需要通过实现接口、使用特性和实现<code>seoable()</code>方法来准备您的模型，如下所示 <pre>class User implements Seoable { use SeoableTrait; ... public function seoable() { } }</pre> <h3 class="heading-element">标签设置</h3><a id="user-content-tags-setting" class="anchor" href="#user-content-tags-setting" rel="nofollow noindex noopener external ugc"></a> 使用<code>seo()</code>方法，并通过fluent API设置字段 <pre>public function seoable() { $this->seo() ->setTitle('full_name') ->setDescription('full_name'); }</pre> 然后设置模板，如下例所示 <pre>return [ \App\User::class => [ 'title' => 'This is page title for user profile :full_name', 'description' => 'This is page description for user profile :full_name', 'twitter_card' => [ 'title' => 'Page title for twitter card :full_name', 'description' => 'Page description for twitter card :full_name' ], 'open_graph' => [ 'title' => 'Page title for open graph :full_name', 'description' => 'Page description for open graph :full_name' ] ] ];</pre> 如果您没有声明它，将默认使用字段值 您还可以通过在方法后添加Raw后缀来设置原始属性 <pre>public function seoable() { $this->seo() ->setTitleRaw('Some awesome title') ->setDescriptionRaw('Some awesome description'); }</pre> 您可以通过放置关联数组来传递多个属性并设置自定义名称 <pre>public function seoable() { $this->seo() ->setTitle(['name' => 'full_name', 'address' => 'email']) ->setDescription('full_name'); }</pre> 您可以使用<code>seoData()</code>关系将附加到模型的SEO元标签保存 <pre>$user = User::find(1) $user->seoData->update(['meta' => ['title' => 'some title']]);</pre> 存储的标签优先于在<code>seoable()</code>方法中设置的标签 * <h3 class="heading-element">填充标签</h3><a id="user-content-filling-tags" class="anchor" href="#user-content-filling-tags" rel="nofollow noindex noopener external ugc"></a> 在您的控制器中，您可以像这样调用<code>seoable()</code>方法 <pre>public function show($post) { $post->seoable() ... }</pre> 如果您想覆盖一些元标签 <pre>public function show($post) { $post->seoable()->meta() ->setTitleRaw('Some Post Title'); ... }</pre> 如果您需要忽略模型在数据库中存储的标签 <pre>public function show($post) { $post->seoable()->meta()->ignoreStored() ->setTitleRaw('Some Post Title'); ... }</pre> <h3 class="heading-element">标签生成</h3><a id="user-content-tags-generating" class="anchor" href="#user-content-tags-generating" rel="nofollow noindex noopener external ugc"></a> 将以下行放入<code><head></code>标签内 <pre><head> ... {!! resolve('seotools')->generate() !!} ... </head></pre> 或者您可以将Facade添加到<code>app.php</code>配置中 <pre>'aliases' => [ // other Facades ommited 'SEO' => Artesaos\SEOTools\Facades\SEOTools::class, ]</pre> 并使用它而不是<code>resolve('seotools')</code> <pre><head> ... {!! SEO::generate() !!} ... </head></pre> 要设置默认元标签值，只需发布SEOTools配置 <pre>php artisan vendor:publish --provider="Artesaos\SEOTools\Providers\SEOToolsServiceProvider"</pre> 您可以在<a href="https://github.com/spatie/laravel-permission/blob/master/README.md" rel="nofollow noindex noopener external ugc">SEOTools Readme</a>上找到完整的用法文档 <h4 class="heading-element">完整的fluent API</h4><a id="user-content-full-fluent-api" class="anchor" href="#user-content-full-fluent-api" rel="nofollow noindex noopener external ugc"></a> <pre>public function seoable() { return $this->seo() ->setTitle(['name', 'email']) ->setDescription('name') ->setCanonical('url') ->setPrev('link') ->setNext('link') ->setKeywords('keywords') ->setLanguages([ [ 'lang' => 'ru', 'url' => 'lang_url' // Resolving by model attribute ] ]) ->addLanguage('en', 'lang_url') ->addMeta('foo', 'bar') ->setMeta([ [ 'meta' => 'some', 'value' => 'name' ], [ 'meta' => 'another', 'value' => 'tag' ] ]) ->twitter() ->setTitle('name') ->setDescription('name') ->setUrl('url') ->setSite('site_name') ->setType('type') ->setImages(['avatar', 'image']) ->addValue('foo', ['name', 'name']) ->setValues([ [ 'key' => 'foo', 'value' => 'attribute' ], [ 'key' => 'another', 'value' => 'another_attribute' ] ]) ->opengraph() ->setTitle('name') ->setDescription(['name', 'email']) ->setUrl('url') ->setSiteName('site_name') ->setImages(['avatar', 'image']) ->setProperties([ [ 'key' => 'foo', 'value' => 'attribute' ], [ 'key' => 'another', 'value' => 'another_attribute' ] ]) ->addProperty('foo', ['name', 'email']); }</pre> <h2 class="heading-element">更新日志</h2><a id="user-content-changelog" class="anchor" href="#user-content-changelog" rel="nofollow noindex noopener external ugc"></a> 请参阅<a href="https://github.com/mad-web/laravel-seoable/blob/HEAD/CHANGELOG.md" rel="nofollow noindex noopener external ugc">CHANGELOG</a>以获取有关最近更改的更多信息 <h2 class="heading-element">测试</h2><a id="user-content-testing" class="anchor" href="#user-content-testing" rel="nofollow noindex noopener external ugc"></a> <pre>$ composer test</pre> <h2 class="heading-element">贡献</h2><a id="user-content-contributing" class="anchor" href="#user-content-contributing" rel="nofollow noindex noopener external ugc"></a> 请参阅<a href="https://github.com/mad-web/laravel-seoable/blob/HEAD/CONTRIBUTING.md" rel="nofollow noindex noopener external ugc">CONTRIBUTING</a>和<a href="https://github.com/mad-web/laravel-seoable/blob/HEAD/CONDUCT.md" rel="nofollow noindex noopener external ugc">CONDUCT</a>以获取详细信息。 <h2 class="heading-element">安全</h2><a id="user-content-security" class="anchor" href="#user-content-security" rel="nofollow noindex noopener external ugc"></a> 如果您发现任何与安全相关的问题，请通过电子邮件<a href="mailto:madweb.dev@gmail.com" rel="nofollow noindex noopener external ugc">madweb.dev@gmail.com</a>而不是使用问题跟踪器。 <h2 class="heading-element">致谢</h2><a id="user-content-credits" class="anchor" href="#user-content-credits" rel="nofollow noindex noopener external ugc"></a> <ul> <li><a href="https://github.com/mad-web" rel="nofollow noindex noopener external ugc">Mad Web</a></li> <li><a href="https://github.com/mad-web/laravel-seoable/blob/HEAD/../../contributors" rel="nofollow noindex noopener external ugc">所有贡献者</a></li> </ul> <h2 class="heading-element">许可证</h2><a id="user-content-license" class="anchor" href="#user-content-license" rel="nofollow noindex noopener external ugc"></a> MIT许可证。请参阅<a href="https://github.com/mad-web/laravel-seoable/blob/HEAD/LICENSE.md" rel="nofollow noindex noopener external ugc">许可证文件</a>获取更多信息。 </div> </div> </div> </section> </section> </section> <footer class="wrapper-footer"> <nav class="container"> <div class="row"> <ul class="social col-xs-7 col-sm-4 col-md-2 pull-right"> <li><a href="http://github.com/composer/packagist" title="GitHub"></a></li> <li><a href="https://twitter.com/packagist" title="Follow @packagist"></a></li> <li><a href="mailto:contact@packagist.org" title="Contact"></a></li> </ul> <ul class="col-xs-4 col-sm-4 col-md-2"> <li><a href="/about">About Packagist</a></li> <li><a href="/feeds/" rel="nofollow">Atom/RSS Feeds</a></li> </ul> <div class="clearfix visible-xs-block"></div> <ul class="col-xs-3 col-sm-4 col-md-2"> <li><a href="/statistics" rel="nofollow">Statistics</a></li> <li><a href="/explore/">Browse Packages</a></li> </ul> <div class="clearfix visible-xs-block visible-sm-block"></div> <ul class="col-xs-3 col-sm-4 col-md-2"> <li><a href="/apidoc">API</a></li> <li><a href="/mirrors">Mirrors</a></li> </ul> <div class="clearfix visible-xs-block"></div> <ul class="col-xs-3 col-sm-4 col-md-2"> <li><a href="https://status.packagist.org/">Status</a></li> <li><a href="https://p.datadoghq.com/sb/x98w56x71erzshui-4a54c45f82bacc991e83302548934b6a">Dashboard</a></li> </ul> </div> <div class="row sponsor"> Packagist maintenance and hosting provided by <a href="https://packagist.com/"><img alt="Private Packagist" src="/img/private-packagist.svg?v=1726064759"></a> </div> <div class="row sponsor"> Monitoring provided by <a href="https://datadog.com/"><img alt="Datadog" src="/img/datadog-light.png?v=1726064759"></a> </div> </nav> </footer> <script nonce="wT/ieUmpI1QLBmE7J8zqKQ=="> var algoliaConfig = {"app_id":"M58222SH95","search_key":"5ae4d03c98685bd7364c2e0fd819af05","index_name":"packagist"}; window.process = { env: { DEBUG: undefined }, }; </script> <script nonce="wT/ieUmpI1QLBmE7J8zqKQ==" src="/build/app.js?v=1726064759"></script> </body></html>

mad-web/laravel-seoable

维护者

详细信息

README