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 . '"]');

        $content .= '<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.

Saiy2k Nostr Components