Tilda / HTML
Setup guide · 1.0.0-rc1
This is a release candidate. Before production, validate the package on a staging site with your CMS version, theme and project public token. No marketplace certification is claimed.
Before installation
Create a Vinalfa project, activate Trial or a subscription and allow your site origin for its public widget token. Never put a server Bearer token here.
Installation and placement
- Open vinalfa-embed.html and replace project placeholders. On Tilda, paste it into a T123 block.
- Publish the test page: Tilda editor preview does not run scripts. Other builders must permit JavaScript and iframe srcdoc; Wix support is not claimed for this release.
Enter CONFIG_ID, public widget token, language and your store HTTPS search URL containing {article}. Set the same URL in the Vinalfa project: project settings may override adapter parameters. Verify OEM/SKU search in your store.
After installation
Test VIN/frame → vehicle → diagram → OEM number → your store search, page refresh, access errors and limits. Test the full flow on phones from 320 px. Review cache, CSP and JavaScript optimizers.
Native adapters use hash routing without extra server rules. Theme, builder and React/Vue components use an iframe: the inner catalog position is not retained in the parent page URL.
Integration scope
Catalogs, VIN/frame, diagrams and a link to your store search. Prices, stock, cart and orders stay in the store; product import and price synchronization are not included.
Removal
First remove catalog placements and navigation links. Then disable/uninstall through the CMS or remove only the added files after a backup. Uninstalling the Bitrix module preserves the component and pages; full removal is a separate step.
Build verification
The plugin was tested on WordPress 6.8.3 with SQLite: activation, settings, shortcode and uninstall. Other CMS adapters passed code and isolated scenario checks without full CMS installations. React/Vue components and the installer were tested with a mocked API, using no VIN quota.