Wix Blocks: Creating and Managing Blocks Dashboard Pages
6 min read
Wix Blocks is currently open to a limited number of users.
Blocks enables you to add a Dashboard Page to your app. Dashboard pages are the back office of your app, allowing site creators to manage the app's data and settings. You can see examples of Dashboard Pages in the Wix apps. For example, this is a Dashboard Page from the Wix Portfolio app:
When a site creator installs your Blocks app on a site, the Dashboard page appears on their site's Dashboard and is named after your application.
Create a Dashboard Page
Add a Dashboard Page to your Blocks app through the App Dashboard icon in the App Structure menu.
Your Dashboard page includes:
- A canvas where you can add elements, such as layout tools, buttons, input texts fields and so on. Blocks provides a template for a commonly used Dashboard user-interface (UI). Of course, you can customize this template. Design your Dashboard page just like you design widgets in Blocks.
- A code section to add code to your dashboard.
Currently, you can only create one Dashboard page for your Blocks app.
Using multi-state boxes in Dashboard pages
Assign a Dashboard Page to an Action Button
One of the most common ways to open a Dashboard page is from the Main Action Button in one of your widget's Action Buttons. To do this:
- Go to the Configuration tab.
- Click on the widget or element that you want to configure.
- Click Edit Action Bar.
- Hover over the main action button (the left button).
- Click Action Button Settings.
- Select Dashboard.
- Select your Dashboard page.
Open a Dashboard Page from a Custom Panel
If you built a custom panel with the Blocks panel builder, you might want to open the Dashboard from that panel. (Learn more about Blocks panels). To do this:
First, get your Dashboard's URL.
- Go to the App Dashboard menu.
- Hover over the Dashboard page's name and click the More Actions icon.
- Click Copy Link.
Now, use this URL in the panel code.
- Go to the Panels tab.
- Select your panel from the My Panels menu.
- Go to the panel's code section (if you don't see the code section, Click the Maximize icon).
- Import the wix-editor module:
1import wixEditor from 'wix-editor';
- Use the openDashboardPanel() function, with the Dashboard URL as a parameter, to open your Dashboard page from the panel. For example:
Add code to your Dashboard Page
Use your Dashboard page's code section to add code to your Dashboard page. Your code can include:
- Business logic, similar to your widgets (Learn more about widget code).
- Working with the data stored in your app's collections (Learn more about collections in Blocks)
- Unique actions for Dashboard Pages (Learn more about the wix-dashboard functions).
To add code to your Dashboard Page:
- Open your Dashboard from the App Dashboard menu.
- Go to your Dashboard's code section (if you don't see the code section, click the Maximize icon).
Dashboard Pages and the Wix Developers Center
Any Dashboard Page created in Blocks will also appear in your app's Components page in the Wix Developers Center. It is shown as a Blocks Dashboard component.
Do not attempt to edit your Blocks Dashboard Page through the Wix Developers Center.
You can also use the Wix Developers Center to create Dashboard Pages for your app. These Dashboard pages are different from the ones you create in Blocks, and consist of an iFrame URL that you provide. They do not have all the capabilities described in this article. They appear in the Wix Developers Center as a plain Dashboard component.
You will see both kinds of pages in your site's Dashboard, once the app in installed on a site.