OGP 2.0.0 brings modern social metadata support to Geeklog

A new major version of the Open Graph Protocol plugin for Geeklog is now available.

OGP 2.0.0 is a substantial modernization of the plugin, with a much clearer focus: generating reliable social metadata for Geeklog pages and for compatible content plugins.

The new version is available from the official Geeklog Plugins repository:

https://github.com/Geeklog-Plugins/ogp

A cleaner role for OGP

Previous versions of OGP had accumulated several features related to Facebook integration, including Like buttons, Facebook Comments, SDK loading, autotags and configuration options.

Those features are now obsolete and have been removed in OGP 2.0.0.

The plugin now concentrates on one responsibility: providing the metadata that social platforms read when a Geeklog page is shared.

This includes:

• Open Graph metadata;
• Twitter/X Card metadata;
• social image metadata;
• image dimensions;
• image alternative text;
• rich video metadata;
• a default social image fallback.

Sharing buttons themselves are intentionally outside the scope of OGP. A theme such as Eclipse, or another dedicated component, can provide Facebook, X/Twitter or LinkedIn sharing buttons while OGP supplies the metadata read by those services.

New provider API for Geeklog plugins

One of the most important additions in OGP 2.0.0 is the new optional provider API:

OGP_registerSocialMetadata()

This allows a content plugin to register authoritative metadata for the page it owns before Geeklog renders the final document header.

A plugin can provide information such as:

• title;
• description;
• canonical URL;
• Open Graph type;
• image;
• image dimensions;
• image alt text;
• Twitter/X card type;
• video URL;
• secure video URL;
• video MIME type.

This means plugins such as document, video, map or media plugins can expose richer social previews without OGP needing plugin-specific SQL queries or hard-coded dependencies.

The first provider that successfully registers metadata owns the social metadata for that request.

Backward compatibility remains important

The provider API is optional.

If no content plugin registers metadata, OGP continues to use its traditional Geeklog page-detection system.

This legacy path has also been significantly improved in version 2.0.0.

For articles, OGP now prefers the dedicated page_title when available and falls back to the normal article title.

For Static Pages, sp_page_title is preferred with sp_title retained as the fallback.

Topic archive pages now use the more appropriate Open Graph type:

website

Configured SEO meta descriptions are also reused whenever possible.

Better Twitter/X support

Twitter/X Cards are now generated alongside Open Graph metadata, including when the historical Geeklog page-detection path is being used.

This gives older Geeklog content much more consistent social previews without requiring every content type to implement a dedicated integration.

Improved image handling

Social networks generally expect relatively large preview images.

OGP 2.0.0 therefore improves image handling considerably.

Local image dimensions can now be detected and included in the generated metadata.

Very small images are rejected as social preview candidates and OGP instead falls back to the configured default social image.

The plugin now ships with a default social image sized at:

1200 × 628 pixels

This provides a more suitable fallback for modern Open Graph and Twitter/X previews.

Rich media support

The new provider contract can also expose richer metadata such as:

• og:image:alt;
• og:video;
• og:video:secure_url;
• og:video:type;
• Twitter/X image metadata;
• Twitter/X image alt metadata.

This is particularly useful for video and media-oriented plugins.

Safer content parsing

OGP 2.0.0 also fixes an issue in the historical autotag parser.

Modern content can contain CSS selectors using square brackets, for example:

input[type=text]

Older parsing behavior could mistakenly interpret this kind of syntax as a Geeklog autotag.

Unknown bracket syntax is now ignored safely, preventing CSS embedded in content from triggering OGP parsing errors.

Legacy Facebook features removed

OGP 2.0.0 removes the old Facebook-specific widget system entirely.

Removed components include:

• Facebook Like widgets;
• Facebook Comments widgets;
• Facebook JavaScript SDK loading;
• Facebook App ID configuration;
• Facebook User ID configuration;
• [ogp:like] autotags;
• [ogp:comments] autotags;
• old template variables;
• associated configuration options.

Old installation documentation referring to these features has also been removed or updated.

Compatibility

OGP 2.0.0 keeps a broad compatibility range:

• Geeklog 1.6.0 or newer
• PHP 5.6.4 or newer

The release pipeline validates the plugin using:

• PHP 5.6;
• PHP 8.1;
• PHP 8.3.

Article page_title support is only used on Geeklog 1.7.0 or newer, allowing the plugin to retain its Geeklog 1.6.0 minimum.

The backward-compatible metadata path has also been manually tested with Geeklog 2.1.1 for articles, topics and Static Pages, as well as with Geeklog 2.2.2.

Improved release engineering

The development process has also been modernized.

The release workflow now validates:

• all shipped PHP and INC files;
• compatibility metadata;
• plugin version information;
• provider API availability;
• removal of obsolete Facebook symbols;
• archive contents;
• default social image presence;
• installable archive integrity.

Successful builds produce an installable archive:

ogp_2.0.0_1.6.0.zip

together with a SHA-256 checksum.

Designed for interoperability

The architecture of OGP 2.0.0 follows a simple principle:

OGP owns social metadata, while content plugins own their content.

Content plugins remain responsible for their canonical URLs and Schema.org structured data.

OGP does not contain hard-coded dependencies on optional plugins. Instead, integrations use the generic provider API.

This makes OGP useful on traditional Geeklog sites while also giving newer plugins a clean way to expose richer metadata.

Download OGP 2.0.0

OGP 2.0.0 is available now from the official Geeklog Plugins repository:

https://github.com/Geeklog-Plugins/ogp

If you maintain a Geeklog site that uses Open Graph metadata, this release is a significant upgrade and provides a much cleaner foundation for modern social sharing.