OctoberCMS：插件擴展性深度探索及軟刪除插件實戰(zhàn)

開發(fā)者通常青睞易用且可擴展的CMS。OctoberCMS 秉持簡潔至上的理念，為開發(fā)者和用戶帶來愉悅的體驗。本文將演示OctoberCMS 的一些可擴展特性，并通過一個簡單的插件擴展另一個插件的功能。

關(guān)鍵要點

• OctoberCMS 提供了一個簡潔易用的CMS，同時允許通過插件進行擴展。這種擴展性體現(xiàn)在開發(fā)者可以深入CMS內(nèi)部機制的程度，包括修改其他開發(fā)者插件的功能。
• Rainlab Blog 插件允許創(chuàng)建文章并將其分配到不同的類別。本教程演示如何擴展此插件，添加軟刪除功能，防止文章被永久刪除，而是標記為“已刪除”并記錄時間戳。
• 要創(chuàng)建軟刪除功能，需要創(chuàng)建一個新插件，并在數(shù)據(jù)庫中添加一個 deleted_at 字段。此字段將保存文章刪除的時間戳。然后，插件擴展文章列表以包含此新字段作為列，并添加一個過濾器來顯示或隱藏已刪除的文章。
• 創(chuàng)建軟刪除功能的最后一步是攔截文章的刪除操作，并更新 deleted_at 列。這是通過掛接到 Eloquent 觸發(fā)的 deleting 事件來實現(xiàn)的，阻止記錄的刪除。取而代之的是，deleted_at 字段將更新為當前時間戳，并保存記錄。

引言

每個CMS都有一個插件系統(tǒng)來擴展平臺的功能，我們通過可以深入CMS內(nèi)部機制的程度來衡量其擴展性。然而，我們這里討論的不僅僅是CMS本身，也包括插件！

如果您構(gòu)建一個插件，您需要確保其他開發(fā)者可以修改您的部分功能。例如，我們有一個博客插件，用戶可以通過選擇列表中的文章來發(fā)布文章。最好觸發(fā)一個事件來表明已發(fā)布新文章，另一個開發(fā)者可以掛接到此事件，并通過電子郵件通知訂閱的用戶！

class Posts extends Controller
{
    public function index_onPublish()
    {
        if (($checkedIds = post('checked')) && is_array($checkedIds) && count($checkedIds)) {

            foreach ($checkedIds as $postId) {
                if ((!$post = Post::find($postId)) || !$post->canEdit($this->user))
                    continue;

                $post->publish();
                Event::fire('rainlab.blog.posts.published', [$post]);
            }

            Flash::success('Successfully published those posts.');
        }

        return $this->listRefresh();
    }
}

其他開發(fā)者可以監(jiān)聽此事件來處理已發(fā)布的文章。

Event::listen('rainlab.blog.posts.published', function($post) {
    User::subscribedTo($post)->each(function($user) use($post) {
        Mail::send('emails.notifications.post-published', ['user' => $user, 'post' => $post], function($message) use($user, $post) {
            $message->from('us@example.com', 'New post by ' . $user->name);

            $message->to($user->email);
        });
    });
});

我們將主要使用事件來掛接到請求周期的不同部分。讓我們從一個具體的例子開始，以便更好地理解。

Rainlab Blog 插件

如果您使用過OctoberCMS一段時間，您一定知道Rainlab Blog插件。它允許您在后端添加文章并將其附加到類別，并且您可以使用組件在前端顯示它們。

在文章列表頁面，我們可以刪除文章。但是，如果我們想軟刪除它們呢？讓我們看看我們能否做到這一點，并了解更多關(guān)于OctoberCMS擴展性的知識。

創(chuàng)建新插件

使用腳手架助手命令創(chuàng)建一個新的插件用于我們的演示，并在Plugin.php文件中更新插件詳細信息。

class Posts extends Controller
{
    public function index_onPublish()
    {
        if (($checkedIds = post('checked')) && is_array($checkedIds) && count($checkedIds)) {

            foreach ($checkedIds as $postId) {
                if ((!$post = Post::find($postId)) || !$post->canEdit($this->user))
                    continue;

                $post->publish();
                Event::fire('rainlab.blog.posts.published', [$post]);
            }

            Flash::success('Successfully published those posts.');
        }

        return $this->listRefresh();
    }
}

擴展數(shù)據(jù)庫模式

談到軟刪除時，首先想到的是數(shù)據(jù)庫中需要存在的 deleted_at 字段列。

在 blogplus/updates 文件夾下創(chuàng)建一個名為 create_posts_deleted_at_field.php 的新文件，并更新 version.yaml 文件。

Event::listen('rainlab.blog.posts.published', function($post) {
    User::subscribedTo($post)->each(function($user) use($post) {
        Mail::send('emails.notifications.post-published', ['user' => $user, 'post' => $post], function($message) use($user, $post) {
            $message->from('us@example.com', 'New post by ' . $user->name);

            $message->to($user->email);
        });
    });
});

php artisan create:plugin rafie.blogplus

遷移類將更改 rainlab_blog_posts 表并添加我們的 deleted_at 列，其默認值為 null。不要忘記運行 php artisan plugin:refresh rafie.blogplus 命令才能使更改生效。

擴展文章列表

接下來，我們必須將我們的字段作為列添加到列表中以進行顯示。OctoberCMS 為我們提供了一個事件來掛接，并更改當前顯示的小部件（后端列表被認為是小部件）。

# updates/version.yaml

1.0.1:
    - First version of blogplus.
    - create_posts_deleted_at_field.php

注意：以上代碼應放在 Plugin@boot 方法中。

我們有一個 if 語句來防止我們的代碼在每個頁面上執(zhí)行，然后我們將一個新列添加到列表小部件中，我們還可以使用 removeColumn 方法刪除任何現(xiàn)有的列。查看文檔以了解可用的列選項列表。

擴展過濾器

文章列表頂部的欄允許用戶使用日期、類別等過濾列表。在我們的例子中，我們需要一個過濾器來顯示/隱藏已刪除的文章。

# updates/create_posts_deleted_at_field.php

use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;

class CreatePostsDeletedAtField extends Migration
{
    public function up()
    {
        Schema::table('rainlab_blog_posts', function (Blueprint $table) {
            $table->timestamp('deleted_at')->nullable()->default(null);
        });
    }

    public function down()
    {
        Schema::table('rainlab_blog_posts', function (Blueprint $table) {
            $table->dropColumn('deleted_at');
        });
    }
}

您可以在文檔中閱讀更多關(guān)于列表過濾器的信息。上面的代碼相當簡單，只包含幾個選項。但是，scope 屬性應該是 Models\Post 模型實例中定義的查詢范圍方法的名稱。

可擴展類

OctoberRainExtensionExtendableTrait trait 提供了一種神奇的方法來動態(tài)擴展現(xiàn)有類，方法是添加新的方法、屬性、行為等。在我們的示例中，我們需要向文章模型添加一個新方法來處理我們的范圍過濾器。

// plugin.php  在Plugin類的boot方法中

Event::listen('backend.list.extendColumns', function ($widget) {
    if (!($widget->getController() instanceof \Rainlab\Blog\Controllers\Posts)) {
        return;
    }

    $widget->addColumns([
        'deleted_at' => [
            'label' => 'Deleted',
            'type' => 'date',
        ],
    ]);
});

我們可以對 addDynamicProperty、asExtension 等做同樣的事情。讓我們刷新我們的文章列表，看看我們的更改是否有效。

當然，我們還沒有任何已刪除的文章，因為我們需要完成最后一部分：攔截文章的刪除操作，只更新 deleted_at 列。

提示：與其使用 scope 屬性，您可以使用條件來指定一個簡單的 where 條件。下面的代碼與使用模型范圍的效果相同。

class Posts extends Controller
{
    public function index_onPublish()
    {
        if (($checkedIds = post('checked')) && is_array($checkedIds) && count($checkedIds)) {

            foreach ($checkedIds as $postId) {
                if ((!$post = Post::find($postId)) || !$post->canEdit($this->user))
                    continue;

                $post->publish();
                Event::fire('rainlab.blog.posts.published', [$post]);
            }

            Flash::success('Successfully published those posts.');
        }

        return $this->listRefresh();
    }
}

Eloquent 事件

Eloquent 在每個操作（創(chuàng)建、更新、刪除等）上都會觸發(fā)一系列事件。在這種情況下，我們需要掛接到刪除事件并阻止記錄的刪除。

刪除記錄時，在執(zhí)行實際刪除操作之前會觸發(fā) deleting 事件，之后會觸發(fā) deleted 事件。如果您在 deleting 事件中返回 false，則操作將中止。

Event::listen('rainlab.blog.posts.published', function($post) {
    User::subscribedTo($post)->each(function($user) use($post) {
        Mail::send('emails.notifications.post-published', ['user' => $user, 'post' => $post], function($message) use($user, $post) {
            $message->from('us@example.com', 'New post by ' . $user->name);

            $message->to($user->email);
        });
    });
});

現(xiàn)在我們準備測試最終結(jié)果！繼續(xù)刪除一些記錄，然后轉(zhuǎn)到文章列表頁面，看看是否可以切換列表中的已刪除項目。

結(jié)論

本文快速概述了如何擴展 OctoberCMS 平臺的不同部分。您可以在文檔的擴展插件部分閱讀更多相關(guān)信息。如果您有任何問題或意見，請在下方留言！

關(guān)于擴展 OctoberCMS 和構(gòu)建軟刪除插件的常見問題

OctoberCMS 中軟刪除插件的用途是什么？

OctoberCMS 中的軟刪除插件旨在防止永久性數(shù)據(jù)丟失。當您刪除記錄時，它不會從數(shù)據(jù)庫中完全刪除。相反，會為該記錄設置一個 deleted_at 時間戳。這意味著從應用程序的角度來看，該記錄被認為是“已刪除”的，但如果需要，仍然可以檢索到它。這在可能意外刪除數(shù)據(jù)的場景中特別有用，因為它允許輕松恢復。

軟刪除功能與硬刪除有何不同？

硬刪除會永久地從數(shù)據(jù)庫中刪除記錄，除非您有備份，否則無法恢復。另一方面，軟刪除只是將記錄標記為已刪除，而不會實際將其從數(shù)據(jù)庫中刪除。這允許您在需要時恢復記錄。

如何在 OctoberCMS 中實現(xiàn)軟刪除功能？

要在 OctoberCMS 中實現(xiàn)軟刪除功能，您需要創(chuàng)建一個插件。這包括創(chuàng)建一個新插件，向數(shù)據(jù)庫表添加 deleted_at 列，并更新您的模型以使用 SoftDeletes trait。然后，您可以使用模型上的 delete 方法來軟刪除記錄，并使用 restore 方法來恢復它。

如何測試 OctoberCMS 中的軟刪除功能？

您可以通過創(chuàng)建單元測試來測試軟刪除功能。這包括創(chuàng)建一個新的測試用例，在數(shù)據(jù)庫中創(chuàng)建一個新記錄，軟刪除它，然后斷言它仍然存在于數(shù)據(jù)庫中，但被標記為已刪除。

我可以將軟刪除功能與現(xiàn)有記錄一起使用嗎？

是的，您可以將軟刪除功能與現(xiàn)有記錄一起使用。您只需要向現(xiàn)有的數(shù)據(jù)庫表添加 deleted_at 列。所有現(xiàn)有記錄的此列都將具有 null 值，表示它們尚未被刪除。

如何在 OctoberCMS 中恢復軟刪除的記錄？

要恢復軟刪除的記錄，您可以使用模型上的 restore 方法。這將從記錄中刪除 deleted_at 時間戳，有效地“取消刪除”它。

我可以在 OctoberCMS 中永久刪除軟刪除的記錄嗎？

是的，您可以使用模型上的 forceDelete 方法永久刪除軟刪除的記錄。這將像硬刪除一樣從數(shù)據(jù)庫中刪除記錄。

如何在 OctoberCMS 中查看所有記錄，包括軟刪除的記錄？

要查看所有記錄，包括軟刪除的記錄，您可以使用模型上的 withTrashed 方法。這將返回所有記錄，無論它們是否已被軟刪除。

我可以在 OctoberCMS 中自定義 deleted_at 列的名稱嗎？

是的，您可以通過覆蓋模型中的 getDeletedAtColumn 方法來自定義 deleted_at 列的名稱。如果 deleted_at 不適合您的需求，這允許您使用不同的列名。

我可以在 OctoberCMS 中為某些記錄禁用軟刪除功能嗎？

是的，您可以使用模型上的 withoutGlobalScope 方法為某些記錄禁用軟刪除功能。這允許您從軟刪除功能中排除某些記錄。

以上是延長10月CMS-構(gòu)建軟耗盡插件的詳細內(nèi)容。更多信息請關(guān)注PHP中文網(wǎng)其他相關(guān)文章！