Skip to content

Commit

Permalink
doc: Improve docs of zotonic_status site.
Browse files Browse the repository at this point in the history
  • Loading branch information
Arjan Scherpenisse committed Oct 31, 2012
1 parent 6de5195 commit 4b421f0
Show file tree
Hide file tree
Showing 3 changed files with 32 additions and 2 deletions.
Binary file added doc/img/zotonic_status_login.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added doc/img/zotonic_status_sites.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
34 changes: 32 additions & 2 deletions doc/tutorials/zotonic_status.rst
Original file line number Diff line number Diff line change
Expand Up @@ -3,5 +3,35 @@
The Zotonic "status" site
=========================

This manual should what the status site is, how to log in, and what options
you have once logged in.
The Zotonic "status" site is the first thing you see once you have
installed Zotonic, when you do not have any sites configured yet. This
is what it looks like:

.. image:: /img/zotonic_status_login.png

This site is also the `fallback` site for Zotonic.

Since Zotonic supports virtual hosting, it uses the HTTP ``Host:``
parameter to see which site should be served at which URL. If it does
not find a ``Host:`` header, or if the host header does not correspond
to any known Zotonic site, it shows the ``zotonic_status`` site
instead.

Logging in
----------

When logged in to the Zotonic status site, you can manage the running
sites on the system: starting, stopping and upgrading them.

Upon first visit, the site shows a friendly message, which tells
visitors that the site they are looking at has probably not been
configured correctly yes. It also asks for a password to log in.

The password that is used for this is a generated password which sites
in the ``priv/config`` file of the Zotonic folder.

.. image:: /img/zotonic_status_sites.png

The "update" buttons only appear when the site (or Zotonic itself) is
under Mercurial or Git revision control. These buttons do a "pull"
from the repository and then rebuild the system.

0 comments on commit 4b421f0

Please sign in to comment.