The Dashboard

The Dashboard is the standard web based IDE; you will surely use it extensively to manage the applications and check your databases. Looking at its interface is a good way to start exploring py4web and its components.

The main Web page

When you run the standard py4web program, it starts a web server with a main web page listening on http://127.0.0.1:8000 (which means that it is listening on the TCP port 8000 on your local PC, using the HTTP protocol).

You can connect to this main page only from your local PC, using a web browser like Firefox or Google Chrome:

_images/main_page.png

The buttons are:

Login into the Dashboard

Pressing the Dashboard button will forward you to the Dashboard login. Here you must insert the password that you’ve already setup (see set_password command option). If you don’t remember the password, you have to stop the program with CTRL-C, setup a new one and run the py4web again.

_images/dashboard_login.png

After inserting the right Dashboard’s password, it will be displayed with all the tabs compressed.

_images/dashboard.png

Click on a tab title to expand. Tabs are context dependent. For example, open tab “Installed Applications” and click on an installed application to select it.

This will create new tabs “Routes”, “Files”, and “Model” for the selected app.

_images/dashboard_main.png

The “Files” tab allows you to browse the folder that contains the selected app and edit any file that comprises the app. If you edit a file you must click on “Reload Apps” under the “Installed Applications” tab for the change to take effect (except if you use watch with the run command option). If an app fails to load, its corresponding button is displayed in red. Click on it to see the corresponding error.

_images/dashboard_edit.png

The Dashboard exposes the db of all the apps using pydal RESTAPI. It also provides a web interface to perform search and CRUD operations.

_images/dashboard_restapi.png

If a user visits an app and triggers a bug, the user is issued a ticket.

_images/dashboard_error.png

The ticket is logged in py4web database. The Dashboard displays the most common recent issues and allows searching tickets.

_images/dashboard_ticket.png