feat: Initial Implementation of Open Graph (OG) Plugin

plugins/system/jacademyseo_opengraph/jacademyseo_opengraph.php

@@ -0,0 +1,14 @@
+<?php
+defined('_JEXEC') or die;
+
+use Joomla\CMS\Plugin\CMSPlugin;
+
+class PlgContentOgmetadata extends CMSPlugin
+{
+    protected $app;
+
+    public function onContentPrepare($context, &$article, &$params, $limitstart = 0)
+    {
+        // Logic will be added later.
+    }
+}

plugins/system/jacademyseo_opengraph/jacademyseo_opengraph.xml

@@ -0,0 +1,134 @@
+<?xml version="1.0" encoding="utf-8"?>
+<extension type="plugin" group="system" method="upgrade" version="6.0">
+    <name>PLG_SYSTEM_JACADEMYSEO_OPENGRAPH</name>
+    <author>JacademySEO Team</author>
+    <creationDate>2025-06</creationDate>
+    <copyright>(C) 2025 JacademySEO. All rights reserved.</copyright>
+    <license>GNU General Public License version 2 or later</license>
+    <authorEmail>[email protected]</authorEmail>
+    <authorUrl>https://jacademyseo.com</authorUrl>
+    <version>1.0.0</version>
+	<description>PLG_SYSTEM_JACADEMYSEO_OPENGRAPH_DESCRIPTION</description>
+
+    <namespace path="src">JacademySEO\Plugin\System\Jacademyseo_Opengraph</namespace>
+
+    <files>
+        <folder plugin="jacademyseo_opengraph">src</folder>
+        <filename plugin="jacademyseo_opengraph">jacademyseo_opengraph.php</filename>
+        <filename>jacademyseo_opengraph.xml</filename>
+    </files>
+
+    <languages>
+        <language tag="en-GB">language/en-GB/plg_system_jacademyseo_opengraph.ini</language>
+        <language tag="en-GB">language/en-GB/plg_system_jacademyseo_opengraph.sys.ini</language>
+    </languages>
+
+    <config>
+        <fields name="params">
+            <fieldset name="global_og_settings" label="Global OG Settings">
+                <field
+                    name="enable_og_generation"
+                    type="radio"
+                    class="btn-group btn-group-yesno"
+                    default="1"
+                    label="PLG_SYSTEM_JACADEMYSEO_OPENGRAPH_ENABLE_OG_GENERATION"
+                    description="PLG_SYSTEM_JACADEMYSEO_OPENGRAPH_ENABLE_OG_GENERATION_DESC"
+                >
+                    <option value="0">JNO</option>
+                    <option value="1">JYES</option>
+                </field>
+
+                <field
+                    name="global_og_title"
+                    type="text"
+                    label="PLG_SYSTEM_JACADEMYSEO_OPENGRAPH_GLOBAL_OG_TITLE"
+                    description="PLG_SYSTEM_JACADEMYSEO_OPENGRAPH_GLOBAL_OG_TITLE_DESC"
+                    size="50"
+                    maxlength="255"
+                />
+
+                <field
+                    name="global_og_description"
+                    type="textarea"
+                    label="PLG_SYSTEM_JACADEMYSEO_OPENGRAPH_GLOBAL_OG_DESCRIPTION"
+                    description="PLG_SYSTEM_JACADEMYSEO_OPENGRAPH_GLOBAL_OG_DESCRIPTION_DESC"
+                    rows="3"
+                    cols="50"
+                    maxlength="300"
+                />
+
+                <field
+                    name="global_og_image"
+                    type="media"
+                    label="PLG_SYSTEM_JACADEMYSEO_OPENGRAPH_GLOBAL_OG_IMAGE"
+                    description="PLG_SYSTEM_JACADEMYSEO_OPENGRAPH_GLOBAL_OG_IMAGE_DESC"
+                    directory="images"
+                />
+
+                <field
+                    name="global_og_type"
+                    type="list"
+                    default="website"
+                    label="PLG_SYSTEM_JACADEMYSEO_OPENGRAPH_GLOBAL_OG_TYPE"
+                    description="PLG_SYSTEM_JACADEMYSEO_OPENGRAPH_GLOBAL_OG_TYPE_DESC"
+                >
+                    <option value="website">website</option>
+                    <option value="article">article</option>
+                    <option value="blog">blog</option>
+                    <option value="profile">profile</option>
+                    <option value="video">video</option>
+                    <option value="music">music</option>
+                    <option value="book">book</option>
+                    <option value="product">product</option>
+                    <option value="event">event</option>
+                </field>
+            </fieldset>
+
+            <fieldset name="override_settings" label="Override Settings">
+                <field
+                    name="enable_article_override"
+                    type="radio"
+                    class="btn-group btn-group-yesno"
+                    default="1"
+                    label="PLG_SYSTEM_JACADEMYSEO_OPENGRAPH_ENABLE_ARTICLE_OVERRIDE"
+                    description="PLG_SYSTEM_JACADEMYSEO_OPENGRAPH_ENABLE_ARTICLE_OVERRIDE_DESC"
+                >
+                    <option value="0">JNO</option>
+                    <option value="1">JYES</option>
+                </field>
+
+                <field
+                    name="enable_category_override"
+                    type="radio"
+                    class="btn-group btn-group-yesno"
+                    default="1"
+                    label="PLG_SYSTEM_JACADEMYSEO_OPENGRAPH_ENABLE_CATEGORY_OVERRIDE"
+                    description="PLG_SYSTEM_JACADEMYSEO_OPENGRAPH_ENABLE_CATEGORY_OVERRIDE_DESC"
+                >
+                    <option value="0">JNO</option>
+                    <option value="1">JYES</option>
+                </field>
+
+                <field
+                    name="fallback_to_site_logo"
+                    type="radio"
+                    class="btn-group btn-group-yesno"
+                    default="1"
+                    label="PLG_SYSTEM_JACADEMYSEO_OPENGRAPH_FALLBACK_TO_SITE_LOGO"
+                    description="PLG_SYSTEM_JACADEMYSEO_OPENGRAPH_FALLBACK_TO_SITE_LOGO_DESC"
+                >
+                    <option value="0">JNO</option>
+                    <option value="1">JYES</option>
+                </field>
+            </fieldset>
+
+
+        </fields>
+    </config>
+
+    <updateservers>
+        <server type="extension" priority="1" name="JacademySEO Open Graph Plugin Updates">
+            <![CDATA[https://updates.jacademyseo.com/plg_system_jacademyseo_opengraph.xml]]>
+        </server>
+    </updateservers>
+</extension>

plugins/system/jacademyseo_opengraph/language/en-GB/plg_system_jacademyseo_opengraph.ini

@@ -0,0 +1,67 @@
+; JacademySEO Open Graph Plugin Language File
+; Copyright (C) 2025 JacademySEO. All rights reserved.
+; License GNU General Public License version 2 or later
+
+; Plugin Description
+PLG_SYSTEM_JACADEMYSEO_OPENGRAPH_DESCRIPTION="JacademySEO Open Graph Plugin automatically generates Open Graph tags for improved social media sharing. Features hierarchical override system supporting global, category, and article-level metadata configuration."
+
+; Global OG Settings
+PLG_SYSTEM_JACADEMYSEO_OPENGRAPH_GLOBAL_OG_SETTINGS="Global Open Graph Settings"
+
+PLG_SYSTEM_JACADEMYSEO_OPENGRAPH_ENABLE_OG_GENERATION="Enable OG Tag Generation"
+PLG_SYSTEM_JACADEMYSEO_OPENGRAPH_ENABLE_OG_GENERATION_DESC="Enable automatic generation of Open Graph meta tags for improved social media sharing."
+
+PLG_SYSTEM_JACADEMYSEO_OPENGRAPH_GLOBAL_OG_TITLE="Global OG Title"
+PLG_SYSTEM_JACADEMYSEO_OPENGRAPH_GLOBAL_OG_TITLE_DESC="Default Open Graph title used as fallback when no article or category-specific title is available. Leave empty to use site name."
+
+PLG_SYSTEM_JACADEMYSEO_OPENGRAPH_GLOBAL_OG_DESCRIPTION="Global OG Description"
+PLG_SYSTEM_JACADEMYSEO_OPENGRAPH_GLOBAL_OG_DESCRIPTION_DESC="Default Open Graph description used as fallback when no article or category-specific description is available. Maximum 200 characters."
+
+PLG_SYSTEM_JACADEMYSEO_OPENGRAPH_GLOBAL_OG_IMAGE="Global OG Image"
+PLG_SYSTEM_JACADEMYSEO_OPENGRAPH_GLOBAL_OG_IMAGE_DESC="Default Open Graph image used as fallback when no article or category-specific image is available. Recommended size: 1200x630 pixels."
+
+PLG_SYSTEM_JACADEMYSEO_OPENGRAPH_GLOBAL_OG_TYPE="Global OG Type"
+PLG_SYSTEM_JACADEMYSEO_OPENGRAPH_GLOBAL_OG_TYPE_DESC="Default Open Graph type for your website. 'Website' is recommended for most sites."
+
+; Override Settings
+PLG_SYSTEM_JACADEMYSEO_OVERRIDE_SETTINGS="Override Settings"
+
+PLG_SYSTEM_JACADEMYSEO_OPENGRAPH_ENABLE_ARTICLE_OVERRIDE="Enable Article-Level Override"
+PLG_SYSTEM_JACADEMYSEO_OPENGRAPH_ENABLE_ARTICLE_OVERRIDE_DESC="Allow articles to have custom Open Graph metadata via custom fields. When enabled, article OG fields will take priority over category and global settings."
+
+PLG_SYSTEM_JACADEMYSEO_OPENGRAPH_ENABLE_CATEGORY_OVERRIDE="Enable Category-Level Override"
+PLG_SYSTEM_JACADEMYSEO_OPENGRAPH_ENABLE_CATEGORY_OVERRIDE_DESC="Allow categories to have custom Open Graph metadata. When enabled, category OG settings will take priority over global settings but will be overridden by article-specific settings."
+
+PLG_SYSTEM_JACADEMYSEO_OPENGRAPH_FALLBACK_TO_SITE_LOGO="Use Site Logo as Fallback"
+PLG_SYSTEM_JACADEMYSEO_OPENGRAPH_FALLBACK_TO_SITE_LOGO_DESC="When no OG image is specified, use the site's logo as fallback image. If disabled, no image tag will be generated."
+
+; Custom Fields Labels (for reference)
+PLG_SYSTEM_JACADEMYSEO_OPENGRAPH_FIELD_OG_TITLE="Open Graph Title"
+PLG_SYSTEM_JACADEMYSEO_OPENGRAPH_FIELD_OG_TITLE_DESC="Custom title for Open Graph sharing. Leave empty to use article title."
+
+PLG_SYSTEM_JACADEMYSEO_OPENGRAPH_FIELD_OG_DESCRIPTION="Open Graph Description"
+PLG_SYSTEM_JACADEMYSEO_OPENGRAPH_FIELD_OG_DESCRIPTION_DESC="Custom description for Open Graph sharing. Leave empty to use article meta description or intro text."
+
+PLG_SYSTEM_JACADEMYSEO_OPENGRAPH_FIELD_OG_IMAGE="Open Graph Image"
+PLG_SYSTEM_JACADEMYSEO_OPENGRAPH_FIELD_OG_IMAGE_DESC="Custom image for Open Graph sharing. Leave empty to use article intro image or site logo."
+
+; Error Messages
+PLG_SYSTEM_JACADEMYSEO_OPENGRAPH_ERROR_INVALID_CATEGORY="Invalid category specified for OG metadata"
+PLG_SYSTEM_JACADEMYSEO_OPENGRAPH_ERROR_SAVE_FAILED="Failed to save OG metadata"
+PLG_SYSTEM_JACADEMYSEO_OPENGRAPH_ERROR_DELETE_FAILED="Failed to delete OG metadata"
+PLG_SYSTEM_JACADEMYSEO_OPENGRAPH_ERROR_FIELD_TOO_LONG="Field value exceeds maximum length"
+
+; Success Messages
+PLG_SYSTEM_JACADEMYSEO_OPENGRAPH_SUCCESS_SAVED="OG metadata saved successfully"
+PLG_SYSTEM_JACADEMYSEO_OPENGRAPH_SUCCESS_DELETED="OG metadata deleted successfully"
+
+; Information Messages
+PLG_SYSTEM_JACADEMYSEO_OPENGRAPH_INFO_NO_ARTICLE="No article context available for OG tag generation"
+PLG_SYSTEM_JACADEMYSEO_OPENGRAPH_INFO_USING_FALLBACK="Using fallback values for OG tag generation"
+PLG_SYSTEM_JACADEMYSEO_OPENGRAPH_INFO_HIERARCHY_APPLIED="OG metadata hierarchy applied: %s level used"
+
+; Priority Levels
+PLG_SYSTEM_JACADEMYSEO_OPENGRAPH_PRIORITY_ARTICLE="Article"
+PLG_SYSTEM_JACADEMYSEO_OPENGRAPH_PRIORITY_CATEGORY="Category"
+PLG_SYSTEM_JACADEMYSEO_OPENGRAPH_PRIORITY_GLOBAL="Global"
+PLG_SYSTEM_JACADEMYSEO_OPENGRAPH_PRIORITY_AUTO="Auto-generated"

plugins/system/jacademyseo_opengraph/language/en-GB/plg_system_jacademyseo_opengraph.sys.ini

@@ -0,0 +1,16 @@
+; JacademySEO Open Graph Plugin System Language File
+; Copyright (C) 2025 JacademySEO. All rights reserved.
+; License GNU General Public License version 2 or later
+
+; Plugin Name and Description for Extension Manager
+PLG_SYSTEM_JACADEMYSEO_OPENGRAPH="System - JacademySEO Open Graph"
+PLG_SYSTEM_JACADEMYSEO_OPENGRAPH_DESCRIPTION="Automatic Open Graph tag generation plugin for Joomla 6.x with hierarchical metadata override system. Improves social media sharing with intelligent fallback mechanisms."
+
+; Installation Messages
+PLG_SYSTEM_JACADEMYSEO_OPENGRAPH_INSTALL_SUCCESS="JacademySEO Open Graph Plugin installed successfully!"
+PLG_SYSTEM_JACADEMYSEO_OPENGRAPH_UPDATE_SUCCESS="JacademySEO Open Graph Plugin updated successfully!"
+PLG_SYSTEM_JACADEMYSEO_OPENGRAPH_UNINSTALL_SUCCESS="JacademySEO Open Graph Plugin uninstalled successfully!"
+
+; Custom Fields Group
+PLG_SYSTEM_JACADEMYSEO_OPENGRAPH_FIELDS_GROUP="Open Graph Metadata"
+PLG_SYSTEM_JACADEMYSEO_OPENGRAPH_FIELDS_GROUP_DESC="Custom fields for Open Graph metadata configuration"