| 97 | | == Editor's Guide == |
| 98 | | 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. |
| 99 | | |
| 100 | | Access your new Apostrophe site's URL to see the home page. |
| 101 | | |
| 102 | | Click "log in" and log in as the admin user (username admin, password demo) |
| 103 | | 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. |
| 104 | | |
| 105 | | === Managing Pages === |
| 106 | | When a user has appropriate privileges on a page, they are able to make |
| 107 | | the following changes by clicking the "This Page" button, then interacting with a simple "breadcrumb trail" that appears at the top of the page: |
| 108 | | |
| 109 | | * Rename the page by clicking on the page title |
| 110 | | * Add a child page beneath the current page |
| 111 | | * Open the page management settings dialog via "This Page," then the "gear" icon |
| 112 | | for less frequent changes |
| 113 | | |
| 114 | | Apostrophe emphasizes "unpublishing" pages as the preferred way |
| 115 | | of "almost" deleting them because it is not permanent. Anonymous users, and users who do not |
| 116 | | have editing privileges on the page, will see the usual 404 Not Found error. |
| 117 | | But users with suitable editing privileges will see the page with its title |
| 118 | | "struck through" and will be able to undelete the page if they desire. This prevents the loss of content. |
| 119 | | |
| 120 | | You can also delete a page permanently via the small X in the lower right |
| 121 | | corner of the page settings dialog. Most of the time that's a shortsighted |
| 122 | | thing to do, but it is useful when you create an unnecessary page by accident. |
| 123 | | |
| 124 | | If you have admin privileges, you can assign editing and managing privileges to other users. You do this by selecting users from the appropriate dropdown on the far right of the page settings dialog. Users with "editing" privileges can edit pages at the level where you assign that privilege and below, but cannot delete pages or make new pages. Users with "managing" privileges can also delete and create pages. |
| 125 | | |
| 126 | | In a typical Apostrophe configuration, users must be members of the "editors" group before you can assign them either editing or managing privileges at some point in the site. If you have admin privileges (and the admin user in a newly created site does have them), you can grant membership in the "editors" group via the "Users" button shown on the top bar next to the Apostrophe icon. |
| 127 | | |
| 128 | | To grant editing or managing privileges for the entire site, grant them from the home page. Privileges "cascade" down through the site to subpages. |
| 129 | | |
| 130 | | The side navigation column also offers an editing tool: users with |
| 131 | | editing privileges can change the order of child pages listed there |
| 132 | | by dragging and dropping them. (If a page has no children, the side |
| 133 | | 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. |
| 134 | | |
| 135 | | === Editing Slots === |
| 136 | | What about the actual content of the page? The editable content |
| 137 | | of a page is stored in "slots" (_note to developers: not the same thing as Symfony slots_). |
| 138 | | |
| 139 | | CMS slots can be of several types: |
| 140 | | |
| 141 | | * Plaintext slots (single line or multiline) |
| 142 | | * Rich text slots (edited via FCK) |
| 143 | | * Feed slots (RSS or Atom feeds, such as Twitter feeds, inserted into a page) |
| 144 | | * Raw HTML slots (best avoided in good designs, but useful when you must paste raw embed codes) |
| 145 | | * Media slots (image, slideshow, video, PDF, button) |
| 146 | | * Custom slots (of any type, implemented as described in the developer's guide section) |
| 147 | | |
| 148 | | 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. |
| 149 | | |
| 150 | | Every slot also offers version control. The arrow-in-a-circle icon |
| 151 | | accesses a dropdown list of all changes that have been made to that slot, |
| 152 | | labeled by date, time and author and including a short summary of the change |
| 153 | | 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. |
| 154 | | |
| 155 | | === Editing Areas === |
| 156 | | In addition to single slots, apostrophePlugin also supports |
| 157 | | "areas." Areas are vertical columns containing more than one slot. |
| 158 | | Editing users are able to add and remove slots from an area at any time, |
| 159 | | selecting from a list of slots approved for use in that area. The slots |
| 160 | | can also be reordered via up and down arrow buttons (used here instead |
| 161 | | of drag and drop to avoid possible browser bugs when dragging and dropping |
| 162 | | complex HTML, and because drag and drop is not actually much fun to use |
| 163 | | when a column spans multiple pages). |
| 164 | | |
| 165 | | 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. |
| 166 | | |
| 167 | | === Revising History === |
| 168 | | 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. |
| 169 | | |
| 170 | | === Editing Media === |
| 171 | | Click "Add Slot," then "Image," then "Select Image." You will be taken to the media area of the site. |
| 172 | | |
| 173 | | 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. |
| 174 | | |
| 175 | | 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. |
| 176 | | |
| 177 | | You can organize media with categories and tags. Add new categories using the "Manage Categories" button at the left, in the media browser area. |
| 178 | | |
| 179 | | 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. |
| 180 | | |
| 181 | | 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. |
| 182 | | |
| 183 | | 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. |
| 184 | | |
| 185 | | === Reorganizing the Site === |
| 186 | | Apostrophe offers drag-and-drop reordering of the children of |
| 187 | | 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. |
| 188 | | |
| 189 | | However, there are times when you want to do something less linear, like moving a page up or down in the page tree. |
| 190 | | |
| 191 | | 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. |
| 192 | | |
| 193 | | This tool is only available to site administrators such as the `admin` user. |
| 194 | | |
