CreamySales - Conversion Widgets for WooCommerce
| 开发者 |
creamyorg
eddr |
|---|---|
| 更新时间 | 2026年8月4日 22:20 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.0 |
| 版权: | GPLv3 or later |
| 版权网址: | 版权信息 |
详情介绍:
CreamySales connects your WooCommerce store to the CreamySales platform, allowing you to display conversion-focused widgets on your storefront.
The plugin is a lightweight connector. Widget creation, design settings, store management, and usage limits are managed from your CreamySales dashboard.
What the Plugin Does
- Connects your WooCommerce store to your CreamySales account.
- Loads the CreamySales widget script on your storefront.
- Allows widgets configured in the CreamySales dashboard to appear on your site.
- Supports WooCommerce stores using Hebrew, English, RTL, and LTR layouts.
- Built for WooCommerce.
- Managed from a central dashboard.
- Works across multiple stores.
- Customizable widget design and behavior.
- Supports Hebrew and English.
- Supports RTL and LTR layouts.
- Loads asynchronously on the frontend.
- No theme file changes required.
- Supports semantic product-title and active-main-image popup placement across classic and block templates.
- Install and activate the plugin.
- Create or log in to your CreamySales account.
- Connect your WooCommerce store.
- Configure widgets from the CreamySales dashboard.
- The plugin loads the active widgets on your storefront.
https://creamysales.com in order to connect your WooCommerce store, load and manage dashboard-configured widgets, synchronize plugin settings, check service connectivity, and record widget interaction events.
A CreamySales account is required to use the service. The service is provided by CreamySales.
The plugin sends the following data to CreamySales:
- Store connection data, including the CreamySales domain ID and plugin enablement status, when settings are saved, when the hourly connection check runs, and when an administrator manually tests the connection.
- The dashboard API key in the
X-Creamy-Keyrequest header when the plugin communicates with the CreamySales dashboard API. - The CreamySales domain ID when requesting the site-specific widget script. The returned script is stored locally under the WordPress uploads directory for performance and integrity control.
- The public site key and widget interaction data from storefront visitors when the frontend collector sends widget analytics and events to CreamySales.
- Limited recent WooCommerce purchase display data, including the customer's first initial or configured complete first name, optional city and country, product name, purchase time, and product thumbnail URL, may be returned by the site's own REST endpoint to display social proof widgets to storefront visitors.
- Aggregate product and variation sales quantities for the configured period may be returned by the site's public sold-count REST endpoint. This response does not contain customer information.
- When the plugin is enabled and an order containing an applied LMS CreamySales coupon reaches processing or completed status, the plugin sends the CreamySales domain ID and dashboard authentication key, event type, order ID and total value, coupon code, product and variation IDs, actual discounted line-item price, and coupon discount type and value. Customer names, email addresses, postal addresses, and other personal data are not included.
安装:
- Upload the plugin files to
/wp-content/plugins/creamysales/, or install the plugin through the WordPress Plugins screen. - Activate the plugin in WordPress.
- Go to Settings -> CreamySales.
- Connect your store to your CreamySales account.
- Configure your widgets from the CreamySales dashboard.
屏幕截图:
常见问题:
Is CreamySales free?
CreamySales offers a free plan for small stores. Paid plans are available for stores that need higher limits or additional features.
Does the plugin work without a CreamySales account?
No. The plugin connects your WooCommerce store to the CreamySales platform, so an account is required.
Does the plugin modify my theme?
No. The widgets are loaded separately and do not require changes to your theme files.
Does it support Hebrew?
Yes. CreamySales supports Hebrew and RTL layouts, as well as English and LTR layouts.
Where do I configure the widgets?
Widgets are configured from the CreamySales dashboard.
Does the plugin slow down my store?
The CreamySales script loads asynchronously and is designed to minimize frontend performance impact.
Can developers customize the recent purchase display data?
Yes. The plugin provides filters for the public herd endpoint so site-specific order data can be adapted without editing plugin files. Available filters:
creamysales_herd_order_cityfilters the displayed city. It receives the sanitized city, the WooCommerce order, and the raw city value.creamysales_herd_order_countryfilters the displayed country. It receives the sanitized country, the WooCommerce order, the country code, and the raw country value.creamysales_herd_purchase_itemfilters the full purchase display item before the final public response is sanitized.
The final herd endpoint response is still limited to the public fieldsname,city,country,time,p_name, andp_img. The CreamySales dashboard can configure whethername` contains the complete billing first name and whether city and country are shown.
How can developers customize semantic popup placement?
CreamySales supports product title and main-image placement plus Elementor Pro product widget anchors for price, rating, stock, short description, add to cart, meta, content, tabs, additional information, upsells, related products, and breadcrumbs. Manual integrations can use:
[creamy_anchor name="product.title.after"]
creamy_render_anchor( 'product.title.after' );
Custom themes can place <span data-creamy-anchor="product.title.after"></span> immediately after their title and add data-creamy-anchor-target="product.main_image" to the stable gallery wrapper containing the current image. This markup defines placement while the CreamySales renderer supplies popup HTML through the namespaced window.CreamySalesAnchors API. Manual theme markup has the highest resolver priority. Complete examples and debugging instructions are in docs/semantic-anchors.md.
Small custom-theme example:
`
Product title
`
Use the stable gallery wrapper as the product.main_image target rather than adding the target attribute directly to the image. CreamySales will resolve the currently visible image inside that wrapper and keep image overlays synchronized when the gallery or selected variation changes.
Where can I get support?
Visit https://creamysales.com or contact support@creamysales.com.
更新日志:
1.46
- Document and narrowly suppress false-positive sold-count SQL warnings.
- Fix the remaining settings update assignment alignment warning.
- Inline prepared sold-count query templates for Plugin Check data-flow compatibility.
- Resolve Plugin Check warnings for the bootstrap variable and prepared sold-count queries.
- Add a custom-theme semantic anchor markup example to the FAQ.
- Add explicit custom-theme HTML integration documentation for semantic popup anchors.
- Make REST option updates atomic and run connection checks only after settings are persisted.
- Replace dated recurring aggregation jobs and per-request script cache busting with stable schedules and content versions.
- Reduce repeated schema, order diagnostic, and current-day aggregation work.
- Consolidate CreamySales HTTP transport and remove unreachable compatibility, queue, authentication, and metadata code.
- Detect Elementor Pro during its early WordPress bootstrap so dedicated product title and product widget anchors activate reliably.
- Add isolated Elementor Pro WooCommerce semantic-anchor integration for product title, image, price, rating, stock, short description, add to cart, meta, content, tabs, additional information, upsells, related products, and breadcrumbs.
- Prefer manual targets, then Elementor single-template widgets, while rejecting hidden, loop, popup, and ambiguous Elementor candidates.
- Reuse the shared flow and image-overlay runtime without Elementor-specific observers or listeners.
- Reuse shared page-class definitions and one body-class snapshot for WooCommerce page detection.
- Reuse the plugin URL constant for bundled frontend asset URLs.
- Add native product ID detection to the WooCommerce page-context JavaScript API.
- Add a lightweight JavaScript API for detecting native WooCommerce product, shop, category, cart, and checkout pages.
- Accept sold-count product IDs as one comma-separated query parameter.
- Reject array-style and malformed sold-count product ID parameters.
- Default main-image popup width to auto.
- Place default top-edge popups on the left in LTR layouts and the right in RTL layouts.
- Standardize plugin JavaScript naming, parameters, variables, spacing, and function documentation.
- Add snake_case semantic-anchor and development test APIs while retaining deprecated renderer compatibility aliases.
- Document all public JavaScript functions and the cached product sold-count endpoint.
- Add public creation, replacement, and removal APIs for renderer-provided popup HTML.
- Mount main-image popups as absolute gallery children without page-scroll positioning.
- Retain the fixed body portal and throttled scroll handling only as a compatibility fallback.
- Make image-popup text selectable and popup controls clickable by default while retaining a low z-index.
- Default main-image popups to a passive full-width top bar below standard gallery controls.
- Add configurable image-popup width, position, and interactivity.
- Reduce scrolling cost with geometry-only, animation-frame overlay updates and focused DOM mutation handling.
- Recognize the main product
core/post-titleblock as a semantic title anchor while rejecting product-loop titles. - Make administrator-authorized frontend anchor diagnostics visibly announce themselves in the browser console.
- Add extensible semantic popup anchors for content after the product title and overlays on the active main product image.
- Integrate automatic resolution with manual markup, WooCommerce Blocks, classic dynamic-priority hooks, and conservative DOM fallbacks.
- Add synchronized external overlays, provider-isolated diagnostics, extension APIs, tests, and developer documentation.
- Normalize legacy dashboard option field names to the renamed herd and sold-count database fields.
- Rename the herd options to
show_full_first_nameandlocation. - Limit the expanded herd customer name to the complete billing first name.
- Rename the sold-count
count_periodsetting toperiod.
- Store nested herd name/location and sold-count period settings received through the authenticated options route.
- Add a cached public sold-count endpoint for bounded product and variation ID sets.
- Support rolling week, 30-day, 60-day, yearly, and all-time sales periods.
- Remove the local Conversion Events option.
- Send eligible conversion events whenever the CreamySales plugin is enabled.
- Check required PHP files before loading plugin modules.
- Skip initialization and show an administrator notice when required WooCommerce APIs are unavailable.
- Restrict CreamySales admin styles to the plugin settings page.
- Restore files omitted from the previous release package.
- Update LMS conversion events to the current CreamySales payload schema.
- Include order value, coupon code, normalized discount type, and actual discounted line-item pricing.
- Redact the dashboard key from administrator conversion-test diagnostics.
- Add an administrator conversion-test tab with HPOS-compatible WooCommerce order autocomplete.
- Allow immediate LMS conversion tests without changing automatic delivery metadata or retries.
- Show the sanitized request payload and CreamySales response for test diagnostics.
- Add privacy-minimized LMS conversion events for eligible processing and completed WooCommerce orders.
- Add asynchronous delivery, retries, idempotency, and successful-delivery order metadata.
- Add an administrator setting to disable conversion events.
- Complete AJAX settings saves without returning HTTP 502 when remote enablement synchronization fails.
- Disable CreamySales locally when a remote disable request fails, while retaining the error for retry and diagnostics.
- Synchronize plugin enable and disable changes with the CreamySales service before updating local state.
- Preserve the previous local status when the service rejects a request or returns a technical error.
- Show CreamySales plan-limit and enablement errors in the AJAX settings response.
- Highlight incompatible resolved order city and country values in the Plugin Check tab.
- Link order-data warnings to the CreamySales WordPress.org FAQ for custom herd endpoint mapping.
- Add an admin warning when the latest order city or country values do not look compatible with the herd endpoint.
- Add a WooCommerce order data compatibility check for herd endpoint city and country values.
- Restore CreamySales service-health notices on the WooCommerce submenu settings screen.
- Update WooCommerce tested compatibility to 10.8.1.
- Move the CreamySales admin page under WooCommerce and add an external-link icon to the plugin support URL.
- Add plugin support links to the CreamySales admin settings page.
- Preserve custom textual herd endpoint country values while avoiding numeric country IDs by default.
- Add herd endpoint filters for site-specific city, country, and purchase display data.
- Normalize herd endpoint country values through WooCommerce country codes.
- Initial public release.