🌐 Language: English | Tiếng Việt

News Plugin for GP247

News management plugin for GP247 Framework with the following features:

Main Features

• Multi-level news category management
• Article management by categories
• Multi-language support for categories and articles
• SEO friendly URLs

License

The GP247 News Plugin is open-sourced software licensed under the MIT license.

Installation Guide

GP247 supports 4 ways to install an extension (plugin/template): Online (from the official library), Import (upload a .zip file), Manual (copy the folder to the server), and Command line (CLI, since gp247 3.x).

Refer to the official documentation: Guide to Installing the Extension.

Method 1: Install Online (from the library)

Step 0 — Register an API License (one-time setup):

• Go to the API License settings in Admin.
• Click "Register/Setup" to obtain a free license key.
• The system automatically saves it to GP247_API_LICENSE in your .env file.

Installation steps:

• Go to the Plugin (or Template) menu and select the Online tab.
• Browse the GP247 extension library; use search/filter to pick a plugin compatible with your current Core version.
• Click Install — the system automatically downloads, validates compatibility, extracts, and installs it.
• A success message appears and the plugin shows up in the installed list.
• Note: paid extensions require their own license key in addition to the free API License.

Method 2: Import zip file

• Go to the Plugin menu and select the Import tab.
• Choose the plugin .zip file from your computer and click Upload — the system validates and installs it automatically.
• ZIP requirements:
  • .zip format only, maximum 50MB.
  • Must contain a gp247.json file at the root level.
  • Must not duplicate the configKey of an existing extension.

Method 3: Manual installation

• Unzip the source and copy the plugin folder (containing AppConfig.php and gp247.json) to:
  • app/GP247/Plugins/News
• If the plugin has a public folder, copy its contents to:
  • public/GP247/Plugins/News
• The plugin auto-appears in Admin > Extensions > Plugins (uninstalled state). Find "News" and click Install to activate.

Method 4: Install from the command line (CLI, gp247 3.x)

Since gp247 3.x you can download News from the GP247 library and install it straight from the command line, without opening the admin. Open a terminal in the website's root folder and run:

# 1) Once per website: register the (free) API License that connects the site to the GP247 library
php artisan gp247:ext-register-license

# 2) Download the plugin from the library and install it
php artisan gp247:ext-install --type=plugin --key=News

• Before step 1, make sure APP_URL in .env is the website's real domain (not http://localhost) — the license is bound to that domain.
• Once installed, the plugin is enabled and caches are refreshed automatically; nothing else is needed in the admin.
• The command checks the requirements declared in gp247.json (core version, composer packages, required plugins) and stops with a clear message if something is missing.
• This plugin requires the gp247/front package; if it is missing, the command stops and tells you.
• If the folder app/GP247/Plugins/News is already on the server (copied manually or shipped with the installer), the command installs it in place instead of downloading it again.
• The command refuses a plugin that is already installed. To move to a newer version, run php artisan gp247:ext-update --type=plugin --key=News.
• Append --json to get machine-readable output (for scripts/CI).
• The Post-Installation section below (Enable/Disable, Config, running php artisan optimize:clear if needed) still applies.
• More: Installing Plugins & Templates · Command reference.

Post-Installation

• Plugins typically work immediately; they may offer Enable/Disable and Config options.
• The system auto-clears the cache. If needed, run:

php artisan optimize:clear

References

• Extension installation guide: https://gp247.net/en/docs/user-guide-extension/guide-to-installing-the-extension.html
• GitHub (News Plugin): https://github.com/gp247net/news