WeddingBlocks
| 开发者 | iwanperkilo |
|---|---|
| 更新时间 | 2026年9月12日 12:53 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
WeddingBlocks is a WordPress plugin that helps you create beautiful digital wedding invitations quickly and easily using the modern Gutenberg block system.
This plugin is perfect for:
- Couples who want to build their own wedding website/invitation
- Web designers / developers offering digital invitation services
- Wedding organizers looking for ready-to-use template layouts
- 🎨 Over 10 custom Gutenberg blocks ready to use
- 📱 Responsive design optimized for all screens
- 💌 RSVP Form with direct database logging
- 📖 Guestbook for guest greetings & wishes
- 🎵 Music Player for automated backsound audio
- 🧩 Full Site Editing (FSE) support
- ⚡ Lightweight, fast, and zero external dependencies
- 🌍 i18n ready (Fully translatable)
- Cover — Welcoming cover screen for the invitation
- Couple Name — Groom & Bride names
- Couple Title — Custom text/greetings (e.g. Putra/Putri dari ...)
- Couple Parents — Parents information
- Couple Photo — Gallery or single photo of the couple
- Couple Info — Brief biography
- Event Info — Wedding event schedule & location details
- Countdown — Countdown clock to the wedding day
- Music Player — Backsound soundtrack player
- Guest Name — Personalized guest name display from URL query
- RSVP Form — Attendance confirmation form
- Guestbook — Wishes, messages, and greetings stream
安装:
- Upload the
weddingblocksdirectory to the/wp-content/plugins/directory, or install it directly via the WordPress admin dashboard. - Activate the plugin through the Plugins menu in WordPress.
- Open the Undangan menu in your admin sidebar to start creating invitations.
- Use the custom WeddingBlocks in the Gutenberg editor to build your invitation page.
屏幕截图:
常见问题:
Is this plugin free?
Yes, WeddingBlocks is 100% free and open-source under the GPL v2 or later license.
Do I need a block / FSE theme?
No. While the plugin works on classic themes, we recommend using a block theme (such as Twenty Twenty-Four) to get the best experience and utilize FSE templates.
How do I add music?
Add the Music Player block to your page, then upload your MP3 audio file in the block settings panel.
Will RSVP responses be saved?
Yes, all RSVP data is securely saved in your WordPress database and can be managed from the admin dashboard under Undangan → RSVP.
Can I translate this plugin?
Absolutely! The plugin is fully translatable and uses the weddingblocks text domain.
更新日志:
1.7.0
- Added: Native WordPress Border Support for Couple Photo block — integrates
__experimentalBorderand border attributes (color, radius, style, width) with support for individual corner radius, color presets, and legacy frame fallback. - Added: Native WordPress Border Support for Couple Info block — adds border color, width, and style support to the couple-info block.
- Added: Font Family support for Couple Info block — new
nameFontFamilyattribute with SelectControl editor interface and localized labels. - Added: Independent Height Control for Couple Photo block — new
heightattribute allowing rectangular photo dimensions instead of forcing a square aspect ratio. - Changed: Refactored couple-photo zoom to use a CSS custom property (
--wb-photo-zoom) instead of inline transform styles, allowing the zoom level to combine with existing hover effects via relative scaling. - Changed: Removed the legacy
shapeattribute (circle, rounded, square) from couple-photo in favor of native WordPress border-radius attributes for more granular control. - Fixed: Zoom focal point maintenance —
object-positionandtransform-originnow use the same focal point so zoom always anchors to that point without pushing it out of frame.
- Added: Focal Point & Zoom Controls for Couple Photo block — new editor controls to set focal point (object-position) and zoom level (transform: scale) without destructive cropping or re-uploading images.
- Fixed: Couple columns alignment — changed align-items from baseline to flex-start to prevent vertical misalignment; added align-self: center to separator column for proper centering.
- Fixed: Replaced background shorthand with explicit background-color to avoid unintended side effects.
- Fixed: Reduced font weight for couple name and fullname styles from 600 to 500 for a lighter, more balanced appearance.
- Separator font inheritance - Removed hardcoded font-family from .weddingblocks-separator in both editor and frontend CSS. The separator now inherits the font-family from .weddingblocks-cover-title to stay consistent with the "Jenis Font Nama Cover" selection.
- Cover wrapper layout - Adjusted minimum width and box-sizing for the cover wrapper to improve stability across devices.
- CSS formatting & responsive layout - Reformatted CSS declarations for better readability and improved responsive behavior for couple columns, avatars, and other components.
- Dynamic Typography & Font Library Integration - Refactored couple-related blocks (couple-name, couple-parents, couple-info) to support dynamic font selection from the WordPress Font Library and theme settings.
- Flexible Font System - Replaced hardcoded font mappings with a flexible system that allows blocks to inherit theme typography by default or use custom font families.
- CSS Variables - Updated CSS to use CSS variables for body, heading, and accent fonts.
- Font Resolution Logic - Implemented font family resolution logic in couple-info, couple-name, and couple-parents blocks.
- Editor Integration - Integrated wp.data to fetch available font families from the editor settings.
- Sanitization - Added sanitization for custom font family strings in PHP render templates.
- Block Attributes - Updated block attributes to use 'default' instead of hardcoded 'playfair'.
- Database & RSVP Queries - Enhanced
weddingblocks_get_rsvps()andweddingblocks_get_rsvps_count()with dynamic search, attendance, and optional status filtering via extensible hooks (weddingblocks_rsvp_search_fields,weddingblocks_rsvp_enable_status_filter). - Cache Reliability - Optimized RSVP count cache handling to ensure accurate and immediate cache invalidation on RSVP submission or deletion.
- Admin RSVP Improvements - Restored native row-action delete button and added clean native attendance status badge styling on the RSVP admin dashboard.
- Extensibility - Added new action and filter hooks (
weddingblocks_show_rsvp_row_actions,weddingblocks_rsvp_extra_columns,weddingblocks_clear_rsvps_count_cache) for seamless add-on integration.
- WordPress 7.1 compatibility - Tested with WordPress 7.1 including the iframed editor, the updated @wordpress/components, and the persistent editor toolbar.
- Couple Title Font Picker - New "Jenis Font Nama Cover" control in the Typography panel for the couple-title block: Playfair Display, Great Vibes, Montserrat, Georgia, System, Sans-serif, and Monospace — all bundled locally or system-based, so no extra webfonts are loaded.
- Theme & WordPress Font Library support - The picker automatically lists fonts registered by the theme (theme.json) and fonts installed through the WordPress Font Library (e.g. uploaded custom fonts), stored as their raw CSS stack and rendered by WordPress on the frontend.
- Live editor preview - The cover title updates instantly when you change the font, with output that matches the guest view (font-family applied with !important to stay consistent with the cover theme styles).
- Continuous / Attention Animations - Added a second, independent animation layer for looping effects: Sway, Float, Pulse, Wobble, and Shake.
- Each block can combine an entrance animation and a continuous effect at the same time without conflicting (the continuous effect waits for the entrance animation to finish first).
- Added Speed and Intensity controls for every continuous animation, plus a Pivot Point (Titik Goyang) control for Sway, Wobble, and Pulse to change where the motion is anchored.
- Continuous animations pause automatically when a block scrolls out of view, and are fully disabled under prefers-reduced-motion, matching the existing entrance-animation accessibility behavior.
- Decorative Layer & Decorative Wrapper - Two new blocks for wrapping any content area with floating decorative elements (butterflies, birds, snow) without affecting the underlying layout.
- Extensibility - Added internal action/filter hook points across block registration, RSVP saving, and the admin RSVP table, laying the groundwork for future add-ons.
- RSVP Form - Added an optional hidden guest-token field, passed through to the RSVP submission when present in the URL. No effect on its own; lays the groundwork for an upcoming add-on to link RSVP submissions back to an imported guest list.
- Design Tokens & Theme-Independent Styling - The invitation now ships with its own default color tokens and typography (h1-h4, paragraph) that no longer depend on the active theme, while remaining editable per-invitation (via a new "Tema Warna" panel) and per-block. Brand colors were migrated to CSS custom properties so a theme color change cascades consistently across all blocks.
- Self-Hosted Local Fonts - Montserrat, Playfair Display, and Great Vibes are now bundled locally (woff2, latin subset) so the plugin's typography renders consistently without relying on any external CDN, matching WordPress.org best practices.
- Animation System - Added a centralized animation system with 5 entrance animation styles (fadeUp, fadeIn, slideLeft, slideRight, zoomIn).
- Scroll-triggered animations powered by native IntersectionObserver with zero external dependencies.
- Added animationStyle, animationDuration, and animationDelay controls to all custom blocks.
- Extended animation support to core WordPress blocks (Heading, Paragraph, Image, and Group).
- Added continuous animations for cover button breathe effect, cover content entrance, and countdown ticking.
- Added interactive visual feedback including avatar hover zoom and button ripple effects.
- Added state animations for RSVP alerts and guestbook item entrances.
- Accessibility - Automatically disables all animations when prefers-reduced-motion is enabled.
- FSE & Template Editor - Blocks can now be used in the WordPress template editor (previously only restricted to "undangan" CPT).
- Comprehensive Settings - Added advanced control panel options for each block.
- CSS & Transition improvements - Simplified block frontend styles and enhanced transitions.
- Music Player - Added customization options to the Music Player block.
- Guest Name - Added prefix toggle, text alignment, and font size options.
- Event Info - Implemented the Event Info block with layout variations and custom editor styles.
- Layout enhancements - Migrated couple and event info layouts to CSS Grid and container queries.
- Cover block improvements - Auto-contrast text color, boxed cover width variant, and admin bar overlap prevention.
- RSVP & Guestbook - Added guest count field, optimized frontend code, and restored scroll position when cover opens.
- 🎉 Initial release of WeddingBlocks
- 11+ custom Gutenberg blocks (cover, countdown, couple info, event info, music player, RSVP, guestbook, etc.)
- Custom Post Type "undangan"
- Admin dashboard to manage RSVPs & guestbook
- Pre-designed invitation template (classic + FSE)
- Full support for Full Site Editing (FSE)
- Zero external dependencies