README

结合Laravel SEO和Filament PHP的功能。

本包是使用laravel-seo包的便捷助手，与Filament Admin和表单一起使用。

它提供了一个简单的组件，返回一个Filament字段组，用于修改SEO模型的、<author>和<description>字段。它自动处理获取和保存所有数据到<code>seo()</code>关系，因此可以在任何地方使用，无需额外配置！ <pre>use Filament\Resources\Form; use RalphJSmit\Filament\SEO\SEO; public static function form(Form $form): Form { return $form->schema([ SEO::make(), // .. Your other fields ]); }</pre> 以下是一个<code>SEO</code>组件的示例 <a target="_blank" href="https://raw.githubusercontent.com/ralphjsmit/laravel-filament-seo/main/docs/images/card.png" rel="nofollow noindex noopener external ugc"><img src="https://rawcdn.githack.com/ralphjsmit/laravel-filament-seo/main/docs/images/card.png" alt="Using the Laravel Filament SEO component"></a> <h2 class="heading-element">安装</h2><a id="user-content-installation" class="anchor" href="#user-content-installation" rel="nofollow noindex noopener external ugc"></a> 首先，安装包 <pre>composer require ralphjsmit/laravel-filament-seo</pre> 这将需要安装<code>ralphjsmit/laravel-seo</code>，如果您尚未安装。请确保<a href="https://github.com/ralphjsmit/laravel-seo" rel="nofollow noindex noopener external ugc">查看主包的文档</a>并配置特殊<code>seo.php</code>配置文件中的值！ 接下来，确保您正在编辑的Eloquent模型使用了<code>HasSEO</code>特质 <pre>class Post extends Model { use HasSEO; }</pre> 现在，<code>SEO::make()</code>助手在任何地方都可以使用。以下是一些如何使用它的示例 <h3 class="heading-element">在Filament Admin中</h3><a id="user-content-in-filament-admin" class="anchor" href="#user-content-in-filament-admin" rel="nofollow noindex noopener external ugc"></a> 这是在经典<a href="https://filamentphp.com/docs/2.x/admin/installation" rel="nofollow noindex noopener external ugc">Filament Admin</a>中使用本包的示例。 它适用于创建和编辑帖子 <pre><?php namespace App\Filament\Resources; use App\Filament\Resources; use App\Models\Post; use Filament\Forms\Components\TextInput; use Filament\Resources\Form; use Filament\Resources\Resource; use Filament\Resources\Table; use RalphJSmit\Filament\SEO\SEO; class PostResource extends Resource { protected static ?string $model = Post::class; protected static ?string $slug = 'posts'; protected static ?string $recordTitleAttribute = 'title'; protected static ?string $navigationGroup = 'Blog'; protected static ?string $navigationIcon = 'heroicon-o-document-text'; protected static ?int $navigationSort = 0; public static function form(Form $form): Form { return $form->schema([ TextInput::make('title'), SEO::make(), ]); } public static function table(Table $table): Table { return $table->columns([ /* */ ]); } public static function getPages(): array { return [ 'index' => Resources\PostResource\Pages\ListPosts::route('/'), 'create' => Resources\PostResource\Pages\CreatePost::route('/create'), 'edit' => Resources\PostResource\Pages\EditPost::route('{record}/edit'), ]; } }</pre> <h3 class="heading-element">与Filament Forms一起使用</h3><a id="user-content-with-filament-forms" class="anchor" href="#user-content-with-filament-forms" rel="nofollow noindex noopener external ugc"></a> 您还可以使用本包与独立的<a href="https://filamentphp.com/docs/2.x/forms/installation" rel="nofollow noindex noopener external ugc">Filament Forms</a>包一起使用。 以下是一个简单的示例，说明如何设置一个创建新帖子的Livewire组件。在这个例子中，我将<code>SEO</code>组件包裹在一个Card中。 <pre><?php namespace App\Http\Livewire; use App\Models\Post; use Filament\Forms\Components\Card; use Filament\Forms\Components\TextInput; use Filament\Forms\Concerns\InteractsWithForms; use Filament\Forms\Contracts\HasForms; use Illuminate\Contracts\View\View; use Illuminate\Database\Eloquent\Model; use Livewire\Component; use RalphJSmit\Filament\SEO\SEO; class CreatePost extends Component implements HasForms { use InteractsWithForms; public array $data = []; public function mount(): void { $this->form->fill(); } public function render(): View { return view('livewire.create-post'); } protected function getFormSchema(): array { return [ TextInput::make('title'), Card::make([ SEO::make() ]), ]; } protected function getFormStatePath(): ?string { return 'data'; } protected function getFormModel(): Model|string|null { return Post::class; } public function submitForm() { $post = Post::create($this->form->getState()); /** Do not forget this step. */ $this->form->model($post)->saveRelationships(); } }</pre> 以下是一个编辑帖子的Livewire组件的示例 <pre><?php namespace App\Http\Livewire; use App\Models\Post; use Filament\Forms\Components\TextInput; use Filament\Forms\Concerns\InteractsWithForms; use Filament\Forms\Contracts\HasForms; use Illuminate\Contracts\View\View; use Illuminate\Database\Eloquent\Model; use Livewire\Component; use RalphJSmit\Filament\SEO\SEO; use RalphJSmit\Filament\SEO\Tests\Fixtures\Models\Post; class EditPost extends Component implements HasForms { use InteractsWithForms; public Post $post; public function mount(): void { $this->form->fill([ 'title' => $this->post->title, ]); } public function render(): View { return view('livewire.edit-post'); } protected function getFormSchema(): array { return [ TextInput::make('title'), SEO::make(), ]; } protected function getFormModel(): Model|string|null { return $this->post; } public function submitForm() { $this->post->update( $this->form->getState(), ); } }</pre> <h2 class="heading-element">通用</h2><a id="user-content-general" class="anchor" href="#user-content-general" rel="nofollow noindex noopener external ugc"></a> 🐞 如果您发现一个错误，请提交详细的问题，我会尽快修复。 🔐 如果您发现一个漏洞，请查看<a href="https://github.com/ralphjsmit/laravel-filament-seo/blob/HEAD/../../security/policy" rel="nofollow noindex noopener external ugc">我们的安全策略</a>。 🙌 如果您想做出贡献，请提交拉取请求。所有PR都将得到充分认可。如果您不确定我会不会接受您的想法，请随时联系我！ 🙋‍♂️ <a href="https://ralphjsmit.com" rel="nofollow noindex noopener external ugc">Ralph J. Smit</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="dWETXCo9xvyyT6OanryLmA=="> var algoliaConfig = {"app_id":"M58222SH95","search_key":"5ae4d03c98685bd7364c2e0fd819af05","index_name":"packagist"}; window.process = { env: { DEBUG: undefined }, }; </script> <script nonce="dWETXCo9xvyyT6OanryLmA==" src="/build/app.js?v=1726064759"></script> </body></html>

ralphjsmit / laravel-filament-seo

维护者

详细信息

README

结合Laravel SEO和Filament PHP的功能。