Add Comments to Your Laravel App

• PHP 8.1+
• Laravel 10, 11, 또는 12

composer require fastcomments/laravel

구성 파일을 게시하세요:

php artisan vendor:publish --tag=fastcomments-config

자격 증명을 .env에 추가하세요:

FASTCOMMENTS_TENANT_ID=your-tenant-id
FASTCOMMENTS_API_KEY=your-api-key

EU 리전의 경우:

FASTCOMMENTS_REGION=eu

댓글 위젯

<x-fastcomments />

{{-- 옵션 포함 --}}
<x-fastcomments
    url-id="my-page-id"
    url="https://example.com/my-page"
    locale="en_us"
    :has-dark-background="true"
    default-sort-direction="MR"
/>

라이브 채팅

<x-fastcomments-live-chat url-id="chat-room-1" />

댓글 수

<x-fastcomments-comment-count url-id="my-page-id" />
<x-fastcomments-comment-count url-id="my-page-id" :number-only="true" />

당신의 .env에서 SSO를 활성화하세요:

FASTCOMMENTS_API_KEY=your-api-key
FASTCOMMENTS_SSO_ENABLED=true
FASTCOMMENTS_SSO_MODE=secure

보안 SSO에는 API 키가 필요합니다 — SSO 페이로드를 서명하는 데 사용됩니다.

구성 기반 매핑

config/fastcomments.php에서 FastComments 필드를 User 모델 속성에 매핑하세요:

'sso' => [
    'enabled' => true,
    'mode' => 'secure',
    'user_map' => [
        'id' => 'id',
        'email' => 'email',
        'username' => 'name',
        'avatar' => 'profile.avatar_url', // 도트 표기법 지원
    ],
    'is_admin' => fn ($user) => $user->hasRole('admin'),
    'is_moderator' => fn ($user) => $user->hasRole('moderator'),
],

인터페이스 기반 매핑

더 세밀한 제어를 위해 User 모델에 MapsToFastCommentsUser 인터페이스를 구현하세요:

use FastComments\Laravel\SSO\Contracts\MapsToFastCommentsUser;

class User extends Authenticatable implements MapsToFastCommentsUser
{
    public function toFastCommentsUserData(): array
    {
        return [
            'id' => (string) $this->id,
            'email' => $this->email,
            'username' => $this->display_name,
            'avatar' => $this->avatar_url,
            'is_admin' => $this->hasRole('admin'),
        ];
    }
}

인터페이스가 구현되어 있으면 구성 기반 매핑보다 우선합니다.

Blade에서의 SSO

SSO가 활성화되면 <x-fastcomments /> 컴포넌트가 인증된 사용자에 대한 SSO 데이터를 자동으로 주입합니다.

퍼사드(Facade)를 통한 사용

use FastComments\Laravel\Facades\FastComments;

// 관리자 API (API 키 필요)
$comments = FastComments::admin()->getComments('tenant-id');

// 공개 API
$comments = FastComments::publicApi()->getCommentsPublic('tenant-id', 'url-id');

// SSO
$ssoPayload = FastComments::sso()->forWidget();
$token = FastComments::sso()->tokenFor($user);

의존성 주입(Dependency Injection)을 통한 사용

use FastComments\Laravel\FastCommentsManager;

class CommentController extends Controller
{
    public function index(FastCommentsManager $fc)
    {
        $comments = $fc->admin()->getComments($fc->tenantId());
        // ...
    }
}

SDK에 직접 접근

use FastComments\Client\Api\DefaultApi;

class CommentController extends Controller
{
    public function index(DefaultApi $api)
    {
        $comments = $api->getComments('tenant-id');
        // ...
    }
}

Blade 템플릿을 사용자 지정하려면:

php artisan vendor:publish --tag=fastcomments-views

템플릿은 resources/views/vendor/fastcomments/에 게시됩니다.