Step Kit OS

説明

Step Kit OS is a comprehensive WooCommerce plugin that brings 3D product customization capabilities to your online store. It allows customers to personalize products in real-time through an interactive iframe interface, creating a unique shopping experience.

Key Features:
– Seamless integration with WooCommerce
– Interactive 3D product customization interface
– Real-time product preview
– Custom product attributes support (size, name, number, signature, badge)
– Dynamic pricing based on customization options (separate pricing for name and number)
– Flexible number pricing (fixed price or per-digit pricing)
– Persistent cart functionality across sessions
– Mobile-responsive design
– Guest user support with proper session handling
– Custom meta data display in cart and orders
– Automatic cart updates and fragment refresh
– Session persistence during login/logout
– Automatic simulator button injection on product pages
– Enhanced security with proper nonce verification

The plugin provides a complete solution for stores looking to offer customizable products with a modern, interactive interface.

Product Setup

  1. Create Required Products:

    • Create four Variable Products in WooCommerce:
      • Main Kit
      • Secondary Kit
      • Third Kit
      • Goalkeeper Kit
    • For each product:
      • Add the “size” attribute with variations (e.g., S, M, L, XL)
      • Set prices and other required fields
      • Publish the products
  2. Configure Product IDs:

    • Go to WooCommerce > Step Kit OS in your WordPress admin
    • In the “Product Configuration” section:
      • Select your products from the dropdown menus for each kit type
      • The dropdowns automatically show all published WooCommerce products
    • Save your settings
  3. Create Simulator Page:

    • Create a new page with the slug “simulador”
    • Add the shortcode [custom_iframe] to the page content
    • Publish the page
  4. Add Simulator Button:

    • Edit your product pages
    • Add the shortcode [simulator_button] where you want the customization button to appear
    • Or enable automatic button injection in the plugin settings
    • Update the product pages

Shortcodes

  • [custom_iframe] – Displays the customization iframe
  • [simulator_button] – Displays the simulator button

Shortcode Parameters:

For [custom_iframe]:
height – Iframe height (default: 100vh)
width – Iframe width (default: 100%)
border – Border style (default: none)
product_id – Specific product ID (optional)

For [simulator_button]:
label – Button text (default: “Customizar Camisola”)
class – CSS classes for styling
product_id – Specific product ID (optional)

Testing

  1. Visit your store’s product page
  2. Click the “Customizar Camisola” button (created by the [simulator_button] shortcode or automatic injection)
  3. You will be redirected to the /simulador page
  4. Test the customization features and complete the purchase flow

スクリーンショット

  • Admin Configuration Displays the admin interface where product IDs are configured.

  • Product Page with Customization Button Displays the product page with the [simulator_button] shortcode.

  • Simulator Page Setup Shows the simulator page [custom_iframe] shortcode for desktop.

  • Simulator Page Setup Shows the simulator page [custom_iframe] shortcode for mobile.

  • Cart with Customized Product Displays how customized products appear in the cart.

  • Checkout with Customizations Shows how customizations appear in the checkout process.

インストール

  1. Download the plugin zip file from the WordPress plugin repository or GitHub
  2. Upload the step-kit-os folder to the /wp-content/plugins/ directory
  3. Activate the plugin through the ‘Plugins’ menu in WordPress
  4. Ensure WooCommerce is installed and activated

FAQ

What are the system requirements?

  • WordPress 5.0 or higher
  • WooCommerce 4.0 or higher
  • PHP 7.4 or higher
  • Modern web browser with JavaScript enabled

How do I add the customization interface to my products?

You can add the customization interface using the [custom_iframe] shortcode or the [simulator_button] shortcode. You can also enable automatic button injection in the plugin settings.

Can I customize the appearance of the iframe?

Yes, the plugin includes CSS styles that can be customized to match your theme. You can modify the styles in your theme’s CSS or through the plugin’s styling options.

How does the cart persistence work?

The plugin includes advanced session handling that ensures cart contents are preserved across page loads, logins, and logouts. It uses a combination of session management and local storage to maintain cart data.

What if I get a “Security token” error?

This issue has been fixed in version 1.1.5. The plugin now properly handles nonce verification and AJAX requests. If you still experience issues, try clearing your browser cache and WordPress cache.

評価

このプラグインにはレビューがありません。

貢献者と開発者

Step Kit OS はオープンソースソフトウェアです。以下の人々がこのプラグインに貢献しています。

貢献者

“Step Kit OS” をあなたの言語に翻訳しましょう。

開発に興味がありますか ?

コードを閲覧するか、SVN リポジトリをチェックするか、開発ログRSS で購読してみてください。

変更履歴

v1.1.5

  • Fixed “Invalid security token” error in add to cart functionality
  • Fixed nonce access bug in iframe-handler.js
  • Added missing AJAX action registration for add_to_cart
  • Standardized nonce creation across the plugin
  • Enhanced debugging and error logging
  • Improved security with proper nonce verification
  • Fixed cart handler AJAX endpoint registration

v1.1.2

  • Added automatic simulator button injection on product pages
  • New setting: Button Color with visual color picker
  • Button now appears automatically under Add to Cart button for configured products
  • Improved settings sanitization and validation

v1.1.1

  • Fixed WordPress coding standards compliance issues
  • Fixed translator comments for internationalization
  • Fixed output escaping for security
  • Fixed $_SERVER variable sanitization
  • Added proper nonce verification comments
  • Enhanced simulator button to only show on configured products
  • Improved product validation and security

v1.0.0

  • Initial release with core functionality:
    • 3D product customization interface
    • WooCommerce integration
    • Custom product attributes
    • Cart persistence
    • Session management
    • Mobile responsiveness
    • Custom meta data handling