README

A Flarum extension that lets forum users connect their LINE account and receive forum notifications (mentions, replies, likes, subscriptions) via LINE push messages.

Features

• 🟢 LINE OAuth connect/disconnect — users link their LINE account from Settings
• 🔔 LINE push notifications — mention, reply, like, new-post notifications delivered as LINE Flex Messages
• 🎨 NGBC Navy/Gold branding — rich Flex Message cards with the forum's color scheme
• ⚙️ Admin settings — Channel ID, Channel Secret, Messaging API Token configurable from Flarum Admin
• 🛡️ Auto-cleanup — if a user blocks the LINE bot, their LINE data is automatically cleared
• 🔗 Webhook endpoint — handles LINE unfollow/block events

Installation

composer require tapao/line-notification
php flarum migrate
php flarum cache:clear

Setup

1. LINE Developers Console

Create two channels on LINE Developers Console:

2. LINE Login Channel settings

• Add callback URL: https://YOUR-FORUM-DOMAIN/api/line/callback
• Enable: profile and openid scopes

3. Messaging API Channel settings

• Register webhook URL: https://YOUR-FORUM-DOMAIN/api/line/webhook
• Issue a Long-lived Channel Access Token

4. Admin panel

Go to Admin → Extensions → LINE Notification and enter:

• LINE Login Channel ID
• LINE Login Channel Secret
• Messaging API Channel Access Token

File Structure

tapao/line-notification/
├── composer.json
├── extend.php                          # Extension entry point
├── migrations/
│   └── 2024_01_01_000001_add_line_fields_to_users.php
├── src/
│   ├── Api/
│   │   └── LineApiClient.php           # HTTP wrapper for LINE APIs
│   ├── Controllers/
│   │   ├── ConnectController.php       # Redirects to LINE OAuth
│   │   ├── CallbackController.php      # Handles OAuth callback
│   │   ├── DisconnectController.php    # Clears LINE user data
│   │   └── WebhookController.php      # Handles LINE webhook events
│   ├── Driver/
│   │   └── LineNotificationDriver.php  # Flarum notification driver
│   ├── Exceptions/
│   │   └── LineUserNotFoundException.php
│   ├── Formatter/
│   │   └── FlexMessageFormatter.php    # Builds LINE Flex Messages
│   └── Listener/
│       ├── AddLineUserAttributes.php   # Exposes LINE fields to API
│       └── SaveLineUserAttributes.php
├── js/
│   ├── package.json
│   ├── webpack.config.js
│   ├── tsconfig.json
│   └── src/
│       ├── forum/
│       │   ├── index.js                # Forum entry point
│       │   └── components/
│       │       └── LineAccountSection.js  # Connect/disconnect UI
│       └── admin/
│           └── index.js                # Admin settings entry point
├── less/
│   ├── forum.less                      # Forum styles
│   └── admin.less                      # Admin styles
└── locale/
    ├── en.yml
    └── th.yml

Architecture

Notification Flow

Flarum notification event
    → Extend\Notification()->type(Blueprint, ['line'])
    → LineNotificationDriver::send($blueprint, $users)
    → FlexMessageFormatter::format($blueprint)
    → LineApiClient::pushMessage($lineUserId, $messages, $token)
    → LINE Messaging API
    → User's LINE app

OAuth Flow

User clicks "Connect LINE" in Settings
    → GET /api/line/connect
    → ConnectController: build authorize URL with signed state
    → Redirect to LINE OAuth
    → User grants consent
    → LINE redirects to GET /api/line/callback?code=...&state=...
    → CallbackController: verify state, exchange code, fetch profile
    → Write line_user_id, line_display_name, line_linked_at to user
    → Redirect to /settings?line_linked=1

License

MIT