When deciding how to design your app, it’s important to know how users will add and use it. Understanding this basic user flow will help you design an app that integrates seamlessly with our platform. The best way to do this is to try it yourself, so we’ll recommend relevant apps in each section to add to your Wix site.
Here’s the basic flow of how users add website apps, or website extensions that are part of a multiextension app.
- Users can browse the App Market and add your app. When users choose to add your app and approve the required permissions, it opens in the Editor.
- Show demo data so that they can quickly get a sense of what your app does.
- Users open the App Settings panel to set up and customize your app.
Keep in Mind:
If your app includes more than one website extension, only the default extension will be added automatically. Users will be able to add the other app extensions, as extensions, from the App Settings of each website extension- so each extension needs its own name, description, and icon (see below).
- Once the site is published, site visitors can see and interact with the app.
As Wix users edit their site in the Wix Editor, they can switch from “editing mode” to “preview mode” to see what their live site will look like. Make sure your app looks the same in “preview mode” as it does in the live site.
You can detect when the user is in preview mode – listen for the
EDIT\_MODE\_CHANGEevent in the
addEventListenermethod. Then just display your app the same way you do in the live site.
When a user deletes a website extension app, their permissions are revoked.
If a user removes one extension of a multiextension app, the permissions will remain.
Here’s the basic flow of how users add dashboard apps, or dashboard extensions that are part of a multiextension app. (You can learn more about the user flow for multiextension apps, below.)
- Users can browse the App Market and add your app to their site’s dashboard. When users choose to add your app and approve the required permissions, the app opens in their dashboard.
- Users can then set up your app, manage it, etc.
If your app also includes a website extension, the user will receive a notification that the app needs to be added to their website from the Editor App Market as well (see Multiextension apps below).
When a user deletes a dashboard app, their permissions are revoked.
If the user removes the dashboard extension of a multiextension app, the permissions will remain.
When users add a website extension that’s part of a multiextension app, the basic flow is a little different.
- Apps with multiple website extensions: When users add your app and approve the required permissions, only the default and essential website extensions are added automatically (you’ll define this in the Wix Developers Center). Users can add the other website extensions from your app’s settings panel.
- Apps with a website extension and a dashboard extension: Users can add your app from the editor or the dashboard (for example, see the
- When users add your app from the editor, the website extension opens. However, the dashboard extension is added as well, and users will see it next time they go to their dashboard.
- When users add your app from the dashboard, the dashboard extension is added right away, and they’ll see a notification telling them to add your website extension.
- Apps with a tracking extension: When users add your app, your app’s dashboard extension opens. The tracking extension is also added, but users can’t see it since it’s invisible.
Example: the app
Deleting one extension of the app will remove that extension from their site, but will not affect the user permissions. To delete the app completely and revoke the user permissions, the user must delete all the app extensions.