activitypub-integrations

Integrate the ActivityPub plugin with WordPress plugins via hooks and filters.

576|90|Updated Jul 10, 2018
One-click install
npx skills add https://github.com/Automattic/wordpress-activitypub --skill activitypub-integrations
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: activitypub-integrations
Source: https://github.com/Automattic/wordpress-activitypub/tree/main/.claude/skills/activitypub-integrations
Command: npx skills add https://github.com/Automattic/wordpress-activitypub --skill activitypub-integrations

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Integrating the ActivityPub plugin with other WordPress plugins can be tricky, requiring specific patterns to ensure compatibility and extend functionality. This Skill provides clear guidance for building robust integrations, saving you time on compatibility issues.

Core Features & Use Cases

  • Integration Patterns: Examples for adding post type support, creating custom transformers for specific content, and modifying ActivityPub activities.
  • Testing & Debugging: Guidance on verifying integration loading, testing compatibility, and resolving common issues like plugin detection and hook priority.
  • Best Practices: Recommendations for robust and maintainable integrations, including checking if a plugin is active and handling deactivation gracefully.

Quick Start

Explain how to add support for a new custom post type from another plugin to the ActivityPub plugin.

Frequently Asked Questions about activitypub-integrations

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add support for a custom post type to the ActivityPub plugin?

To add custom post type support to ActivityPub, register the post type via the `activitypub_supported_post_types` filter, then attach a transformer using hooks to map your post data to ActivityPub activity objects. This enables federation and content sharing across the ActivityPub network.

Can I integrate ActivityPub with WooCommerce, BuddyPress, or other WordPress plugins?

Yes. ActivityPub integrates with WooCommerce, BuddyPress, bbPress, Jetpack, The Events Calendar, and WP User Avatars through plugin-specific transformers and ActivityPub hooks. Each integration follows patterns for detecting active plugins, registering custom types, and modifying activity objects.

What's the best way to debug ActivityPub plugin compatibility issues?

Debug compatibility by verifying integration loading via hook inspection, testing post type registration, checking plugin detection logic, and validating hook priority. Common issues stem from incorrect filter application or missing plugin availability checks before hooking into ActivityPub.

Do I need to check if a WordPress plugin is active before integrating with ActivityPub?

Yes. Always check plugin status before applying ActivityPub hooks to avoid fatal errors. Use standard WordPress functions to verify the target plugin is active, then conditionally register transformers and attach filters only when dependencies are present.

How do I modify ActivityPub activity objects for custom content?

Modify activity objects using ActivityPub filters to transform custom post data into federated format. Attach transformers that map your plugin's content structure to ActivityPub properties, ensuring proper federation and compatibility with remote platforms.

What happens to ActivityPub content when a plugin is deactivated?

When an integrated plugin deactivates, its custom post types should gracefully deregister from ActivityPub to prevent orphaned or misconfigured activities. Design integrations to clean up hooks and transformers during deactivation to maintain federation integrity.