Skip to main content

Migrating to v1.0

Plugin v1.0 introduces a more flexible CSS customization system using CSS variables instead of class overrides, adds a customizable loading bar in 3D, exposes granulated error types and improves memory management.

See the full changelog for details.

Breaking Changes​

CSS Customization​

What changed: The plugin no longer injects default.css. All styling is now controlled through CSS custom properties (variables).

Who's affected: Users who customized the plugin UI by overriding CSS classes like .shopar-btn, .shopar-loading-bar-fg etc.

Migration Steps​

Update CSS Customization​

Replace CSS class overrides with CSS variables. Variables can be set on the target element or any ancestor.

Before (0.9.x):

.shopar-loading-bar-bg {
  background: #f0f0f0;
}

.shopar-loading-bar-fg {
  background: #000000;
  border-radius: 0;
}

After (1.0.0):

#my-target-element {
  --shopar-ar-loading-bar-bg: #f0f0f0;
  --shopar-ar-loading-bar-fg: #000000;
  --shopar-ar-loading-bar-radius: 0;
}

See the Themes page for all available CSS variables.