About this plugin
Nostr Components brings the power of Nostr (Notes and Other Stuff Transmitted by Relays) to your WordPress site through modern web components. This plugin provides Gutenberg blocks and shortcodes that allow you to seamlessly integrate Nostr content into your posts and pages.
Key Features
- Gutenberg Blocks: Modern block editor integration for Nostr Zap button, Post, Profile, Profile Badge, Follow Button, Like Button, and Livestream
- Shortcodes: Classic editor support with simple shortcode syntax
- Selective Loading: Enable only the components you need for optimal performance
- Customizable: Configure relays, themes, and component settings
- Security: Built-in security with custom element allowlist via KSES
- Performance: Conditional asset loading based on enabled components
Available Components
- Nostr Zap button: Allows your readers to zap to your posts and pages
- Nostr Follow Button: Interactive follow/unfollow buttons for Nostr users
- Nostr Post: Display Nostr notes/posts with full content and metadata
- Nostr Profile: Show complete Nostr user profiles with bio, stats, and social links
- Nostr Profile Badge: Compact profile display perfect for sidebars and footers
- Nostr Like Button: Like URLs using Nostr reactions (NIP-25)
- Nostr Livestream: Display Nostr livestreams (NIP-53) with video playback and participant information
How It Works
- Install and activate the plugin
- Go to Settings → Saiy2k Nostr Components to configure
- Enable only the components you need
- Add blocks in the Gutenberg editor or use shortcodes
- Configure relays and theme settings as needed
Example Usage
Gutenberg Blocks:
Simply add the Nostr blocks from the block inserter and configure them in the block settings.
Shortcodes:
[nostr_zap_button pubkey=”npub1abc…” url=””]
[nostr_post eventid=”note1abc…”]
[nostr_profile pubkey=”npub1abc…”]
[nostr_profile_badge pubkey=”npub1abc…”]
[nostr_follow_button pubkey=”npub1abc…”]
[nostr_like_button]
[nostr_livestream naddr=”naddr1abc…”]
Adding Like and Zap Buttons to All Posts/Pages
To automatically add Like and Zap buttons to the end of every post and page:
- Go to Appearance → Theme Editor (or use a child theme for safer customization)
- Select your active theme (or child theme)
- Open functions.php
-
Add the following code at the end of the file:
// Add shortcode to the end of every post and page function add_shortcode_to_content($content) { // Only add in single posts and pages (not homepage or archives) if (is_singular(['post', 'page']) && in_the_loop() && is_main_query()) { $shortcode_1 = do_shortcode('[nostr_like_button]'); $current_url = esc_url(get_permalink()); $shortcode_2 = do_shortcode('[nostr_zap_button npub="[YOUR-NPUB-GOES-HERE]" url="'. $current_url. '"]');
= '<div class="nostr-shortcode-wrapper">'. $shortcode_1. '<br/><br/>'.
$shortcode_2. '</div>'; } return $content; } add_filter('the_content', 'add_shortcode_to_content');
Important Notes:
* Replace [YOUR-NPUB-GOES-HERE] with your actual Nostr public key (npub format)
* Always use a child theme when modifying theme files to preserve changes during theme updates
* The buttons will only appear on single post and page views, not on archive pages or the homepage
Development
This plugin is developed as part of the Nostr Components project. For development, bug reports, and feature requests, please visit the GitHub repository.
Support
For support, please visit the GitHub repository or create an issue.
Privacy Policy
This plugin does not collect, store, or transmit any personal data. All Nostr data is fetched directly from public relays and displayed locally on your site. If components fetch data client‑side, visitors’ browsers may directly connect to configured relays (exposing their IP and user agent to those relays).
Configure trusted relays accordingly.