= Apostrophe Manual =

[ManualOverview Up to the Overview]

== Editor's Guide ==
This section is devoted to users who will participate in editing, maintaining and administering the content of the site. All of these tasks are performed through your web browser. No command line skills are required.

Access your new Apostrophe site's URL to see the home page. 

Click "log in" and log in as the admin user (username admin, password demo)
to see the editing controls. Notice that editing controls are added to the normal experience of the site. This greatly reduces the learning curve for editors.

=== Managing Pages ===
When a user has appropriate privileges on a page, they are able to make
the following changes by clicking the "This Page" button, then interacting with a simple "breadcrumb trail" that appears at the top of the page:

 * Rename the page by clicking on the page title
 * Add a child page beneath the current page
 * Open the page management settings dialog via "This Page," then the "gear" icon for less frequent changes

Apostrophe emphasizes "unpublishing" pages as the preferred way
of "almost" deleting them because it is not permanent. Anonymous users, and users who do not
have editing privileges on the page, will see the usual 404 Not Found error.
But users with suitable editing privileges will see the page with its title
"struck through" and will be able to undelete the page if they desire. This prevents the loss of content.

You can also delete a page permanently via the small X in the lower right
corner of the page settings dialog. Most of the time that's a shortsighted
thing to do, but it is useful when you create an unnecessary page by accident.

The side navigation column also offers an editing tool: users with
editing privileges can change the order of child pages listed there
by dragging and dropping them. (If a page has no children, the side
navigation displays its peers instead, including itself.) You can do the same thing with the tabs at the top of the page. Also check out the "Reorganize" button, which is discussed in more detail later.

=== Editing Slots ===
What about the actual content of the page? The editable content
of a page is stored in "slots" (_note to developers: not the same thing as Symfony slots_).

CMS slots can be of several types:

 * Plaintext slots (single line or multiline)
 * Rich text slots (edited via FCK)
 * Feed slots (RSS or Atom feeds, such as Twitter feeds, inserted into a page)
 * Raw HTML slots (best avoided in good designs, but useful when you must paste raw embed codes)
 * Media slots (image, slideshow, video, PDF, button)
 * Custom slots (of any type, implemented as described in the developer's guide section)

Once you have logged in, you'll note that each editable slot has an "Edit" button or, in the case of the media slots, "Select Image" and similar buttons. 

Every slot also offers version control. The arrow-in-a-circle icon
accesses a dropdown list of all changes that have been made to that slot,
labeled by date, time and author and including a short summary of the change
to help you remember what's different about that version. Pick any version to preview it. Click "Save as current version" to permanently revert to that version. 

=== Editing Areas ===
In addition to single slots, apostrophePlugin also supports
"areas." Areas are vertical columns containing more than one slot.
Editing users are able to add and remove slots from an area at any time, 
selecting from a list of slots approved for use in that area. The slots
can also be reordered via up and down arrow buttons (used here instead
of drag and drop to avoid possible browser bugs when dragging and dropping 
complex HTML, and because drag and drop is not actually much fun to use
when a column spans multiple pages).

The usefulness of areas becomes clear when rich text slots are interleaved with media slots. Media slots provide a robust way to manage photos and videos without wrecking the layout of the site. You can upload photos and select and embed videos freely without worrying about their size and format.

=== Revising History ===
Did you make a mistake? Not a problem! Both slots and areas allow you to roll back to any previous edit. Just click "History," preview versions by clicking on them, and click "Save As Current Revision" when you find the version you want.

=== Editing Media ===
Click "Add Slot," then "Image," then "Select Image." You will be taken to the media area of the site.

Here you can select any of the images that have already been uploaded to the site, or upload new images. This media repository provides a clean way to keep track of the media you have available.

You can do much the same thing with video. YouTube is tightly integrated with Apostrophe, and you can easily search YouTube from within the media interface. You can also paste embed codes from other sites and add thumbnail images for those videos manually.

You can organize media with categories and tags. Add new categories using the "Manage Categories" button at the left, in the media browser area. 

It's possible to add a media page to the public-facing part of the site that displays only media in certain categories. To do that, go to the home page, add a new page and give it a title that relates to a media category. When the new page appears, click "This Page," then the gear icon. When the page settings dialog appears, select "Media" from the "Page Engine" menu.

Once you select Media, a category selector will appear. Pick the appropriate category, then click Save. Note that you can select more than one category.

The page will now refresh and display a media browser that anyone on your site can use to see media in that category, most recent first, with all of the browsing features that are standard in the media area.

=== Reorganizing the Site ===
Apostrophe offers drag-and-drop reordering of the children of
any page via the navigation links on the left-hand side. You can also reorder the tabs at the top of any page by dragging and dropping.

However, there are times when you want to do something less linear, like moving a page up or down in the page tree.

To do that, click on the "Reorganize" button at the top of any page. This will take you to the reorganize tool, a page where you can drag and drop pages to any position in the page tree for quick and painless reorganization of the site.

This tool is only available to site administrators such as the `admin` user.

[ManualDesignersGuide Continue to the Designer's Guide]

[ManualOverview Up to the Overview]