Website Maintenance Tips - Revision history

Shawn: link to FG html basics doc

2009-03-14T13:55:22Z

link to FG html basics doc

Shawn: custom fields for post pages

2008-07-09T02:22:11Z

custom fields for post pages

Shawn: /* Editing Pages */

2008-07-09T02:18:28Z

Editing Pages

Shawn at 01:53, 9 July 2008

2008-07-09T01:53:04Z

Shawn: /* Text Editing */

2008-07-09T01:47:15Z

Text Editing

Shawn: /* Images */

2008-07-02T05:40:37Z

Images

Shawn: centering text

2008-06-25T03:46:32Z

centering text

Shawn at 00:04, 25 June 2008

2008-06-25T00:04:45Z

Shawn: media gallery

2008-06-24T22:32:41Z

media gallery

Shawn: more tag

2008-06-21T20:51:19Z

more tag

@@ Line 2: / Line 2: @@
 * We're using Wordpress v2.5.  For documentation on Wordpress, go to http://codex.wordpress.org/
 * Our stylesheet lives at http://test.freegeek.org/wp-content/themes/freegeek/style.css.  Mess with that document in order to make changes to how text, images, etc. behaves globally.
 **Also check out http://freegeek.org/index/elements/ to see examples of all the CSS styles and how to use them in your code.
 * If you're already logged in and want to edit the site, go to http://freegeek.org/wp-admin/
 * All new website maintainers should get an html refresher (or learn it altogether).  Some online resources:
 ** http://www.w3schools.com/html/html_intro.asp - straight up html lesson/refresher
 ** http://www.accessv.com/~email/webpages/ - html tutorial, more for those who've never learned html before
@@ Line 13: / Line 12: @@
 ==Editing Pages==
-* We've disabled the visual editor for the site.  Believe me, this makes things easier.  If the visual editor wasn't disabled, many elements and plugins on the site would break.
+* We've disabled the visual editor for the site.  Believe me, this makes things easier.  If the visual editor wasn't disabled, many elements and plugins on the site would break.  This means that all maintainers need to know at least the basics of HTML.  Look above for resources.
 * Generally, to edit pages, login and go to Manage -> Pages, then click on the page you'd like to edit.
 * If you're logged in, you'll see an "edit" link near the page title of each page (for easy access to editing functions).

@@ Line 136: / Line 136: @@
 will have to click the "more" link at the bottom of the post to see
 this astounding follow-up to the information above.</pre>
 [[Category:Webadmin]]

@@ Line 18: / Line 18: @@
 * "Keep private" checkbox means that only those with editing logins will be able to see the page
 * "Include this page in user menus" checkbox will make the page title show in the main nav or sub-nav bars.  The site is only set up to show 2 menu levels, so if you're looking at a 3rd-level page like /about/contact/directions and you check this box, you'll break the nav.
-* If you ever ''do'' want to show a 3rd level menu, you should consider turning the sidebar menu back on and configuring it as you'd like.
+** If you ever ''do'' want to show a 3rd level menu, you should consider turning the sidebar menu back on and configuring it as you'd like.
 ===Text Editing===

@@ Line 1: / Line 1: @@
-We're using Wordpress v2.5.  For documentation on Wordpress, go to http://codex.wordpress.org/
+First, some links to important documents.
-Our stylesheet lives at http://test.freegeek.org/wp-content/themes/freegeek/style.css.  Mess with that document in order to make changes to how text, images, etc. behaves globally.
+* We're using Wordpress v2.5.  For documentation on Wordpress, go to http://codex.wordpress.org/
 * If you're already logged in and want to edit the site, go to http://freegeek.org/wp-admin/
-* We've disabled the visual editor for the site.  Believe me, this makes things easier.  If the visual editor wasn't disabled, many elements and plugins on the site would break.
+* All new website maintainers should get an html refresher (or learn it altogether).  Some online resources:
-** All new website maintainers should get an html refresher (or learn it altogether).  Some online resources:
+** http://www.w3schools.com/html/html_intro.asp - straight up html lesson/refresher
-*** http://www.w3schools.com/html/html_intro.asp - straight up html lesson/refresher
+** http://www.accessv.com/~email/webpages/ - html tutorial, more for those who've never learned html before
-*** http://www.accessv.com/~email/webpages/ - html tutorial, more for those who've never learned html before
+** http://www.htmlcodetutorial.com/quicklist.html - reference list of all html markup tags
 ==Editing Pages==
 * Generally, to edit pages, login and go to Manage -> Pages, then click on the page you'd like to edit.
 * If you're logged in, you'll see an "edit" link near the page title of each page (for easy access to editing functions).
@@ Line 23: / Line 26: @@
 <!-- p>This would be commented out.</p -->
 <!-- This would be commented out as well --></pre>
-* Centering, right, left, justify text.  Check out the link to the CSS above to see details.  Generally, you'll need to use a div tag (we're gettin' into CSS stylin's, kids!):
 <pre><div class="center">Text to be centered.</div>
 <div class="right">Text begins from the right side on each line.</div>
 <div class="left">Text begins from the left.</div>
-<div class="justify">Text forms a block.</div></pre>
+<div class="indentleft">Text makes an indentation from the left side of the page</div></pre>
 ** Does the text look funky after you've added these divs?  A little too small, perhaps?  It's because, in wordpress, divs are finicky.  Just make sure to give the div notations lots of space in your code:
 <pre>

@@ Line 28: / Line 28: @@
 <div class="left">Text begins from the left.</div>
 <div class="justify">Text forms a block.</div></pre>
 ===Images===

@@ Line 39: / Line 39: @@
 * All images on pages have been linked to the image file itself.  This means that when it's clicked on, the user will view the full size of the image.  (The other option is to link to the image's own page, which usually has room for comments, etc. We don't want comments, so we've linked to the image directly.)
 * ''Titles, descriptions, captions''.  These fields show up when you look at an image in the media library.
-** Titles are required for each image.  The title is displayed as the short description of an image in the media library.
+** Titles are displayed as the short description of an image in the media library.  The title also pops up when a website viewer mouses over an image.  Generally, this feature seems extraneous and distracting for a site like ours.  All titles have been removed from images: do this when inserting an image into a page through the media library or by deleting the title tag in the html editor.
 ** Captions show up as the alt text for images.  Our site is set up to automatically pull the caption data to show up underneath photos.  If you don't want a caption under a photo, don't fill this field in.
 ** Descriptions appear only on the image's individual page.  We've bypassed this page on our site for simplicity.

@@ Line 1: / Line 1: @@
 We're using Wordpress v2.5.  For documentation on Wordpress, go to http://codex.wordpress.org/
 * If you're already logged in and want to edit the site, go to http://freegeek.org/wp-admin/
@@ Line 37: / Line 39: @@
 The /media/multimedia page holds some print-ready images for journalists to use.  This gallery is created using a special bit of code.  The code is put into action by the [fg-gallery] bit you see in the html when editing that page.  Clicking on any of the thumbnail images will link directly to a high resolution version of that image.
-To upload images to this gallery, just do it from the page like normal.  The new image should show up in the gallery.  The gallery's viewable by clicking on the "Gallery" tab after you've clicked on the media library icon from the html editor.
+To upload images to this gallery, just do it from the page like normal.  The new image should show up in the gallery.  The gallery may be opened for editing by clicking on the "Gallery" tab after you've clicked on the media library icon from the html editor.  Images in the gallery are easily reordered by clicking and dragging from the gallery-editing view.
 ==User Roles==
@@ Line 59: / Line 61: @@
 If you're an administrator, you can change the features of each role (or create a new role) here: http://test.freegeek.org/wp-admin/users.php?page=role-manager/role-management.php  This fine-grain role definition feature is enabled by a plugin: http://www.im-web-gefunden.de/wordpress-plugins/role-manager/
-'''''When creating new users, be sure to disable the visual editor!''''' If you don't, some of the site's underlying code may be compromised, then pages would break.  And no one wants to be broken, especially not websites.
+There's a plugin installed which automatically disables the visual editor for all newly created users.  Even if their "enable visual editor" box is checked on their user settings page, the visual editor will not be enabled.  Just trust us, this is for the best.  See the top of this page for places you can go online to brush up on your html.
 ==Calendar==
@@ Line 85: / Line 87: @@
 ==Welcome and Contact Boxen==
-These boxen show up on the first page (welcome) and all pages (contact).  To edit these, go to Design -> Widgets.  They're text widgets.
+These boxen show up on the first page (welcome) and all pages (contact).  To edit these, go to Design -> Widgets.  They're text widgets.  Only admins have permissions to change these boxen.  In fact, the Welcome box is made mostly of images and not straight html with links, so those who change it should know what they're doing.
 ==News, media coverage, and press release posts==

@@ Line 21: / Line 21: @@
 ==Images==
-* Can be uploaded from any page
+* Can be uploaded from any page a-like so:
-* Click on "Add Images" above the text editing box on the page you'd like to edit
+# Click on "Add Images" above the text editing box on the page you'd like to edit
-* If you want to upload an image, do it there
+# If you want to upload an image, do it there
-* If you want to add an image from the media library, click on that tab.  Choose the image you'd like, and set the title, where you want it on the page (right, left, center) and the size.  If you want a big image on the page, best to pick "full size".  If you choose medium or thumbnail and try to increase the size in the visual editor, the image will become pixelated.  Remember, though, that bigger images lead to longer load time.
+# If you want to add an image that's already been uploaded, click on the media library tab.  Choose the image you'd like, and set the title, where you want it on the page (right, left, center) and the size.
-* Once the image is on the page, be sure to include ''style="float: right;"'' (or left or center)   Otherwise, the image will float above or below the text.
+* ''Sizing''. Generally, it's a good idea to use the medium sized image in order to prevent the long load times that site viewers would experience if full-sized images were used.  If you choose medium or thumbnail and try to increase the size, the image will become pixelated.  Remember, though, that bigger images lead to longer load time.
 * Where the images (and other uploads) are saved: this is useful to know if you want to link a photo to a "hidden" photo behind it (like on the staff page). They're kept in directories sorted by date: /wp-content/freegeek-uploads/<year>/<month>/<filename>.  Look in the media library listing for the photo you want hidden to find its specific URL.
-* All images on pages have been linked to the image file itself.  This means that when it's clicked on, the user will view the image itself.  (The other option is to link to the image's own page, which usually has room for comments, etc. We don't want comments, so we've linked to the image directly.)
+* All images on pages have been linked to the image file itself.  This means that when it's clicked on, the user will view the full size of the image.  (The other option is to link to the image's own page, which usually has room for comments, etc. We don't want comments, so we've linked to the image directly.)
-* Titles, descriptions, captions.  These fields show up when you look at an image in the media library.
+* ''Titles, descriptions, captions''.  These fields show up when you look at an image in the media library.
 ** Titles are required for each image.  The title is displayed as the short description of an image in the media library.
 ** Captions show up as the alt text for images.  Our site is set up to automatically pull the caption data to show up underneath photos.  If you don't want a caption under a photo, don't fill this field in.
 ** Descriptions appear only on the image's individual page.  We've bypassed this page on our site for simplicity.
 ==User Roles==
@@ Line 43: / Line 49: @@
 Since our website focuses more on pages and the person who made the post or page doesn't matter as much, different roles have been set up for us:
-* '''Administrator''' - can edit everything and everyone.  this includes code, plugins, and themes.
+* '''Administrator''' - can edit everything and everyone.  This includes code, plugins, and themes.
 * '''Maintainer''' - able to edit/delete/publish posts and pages, as well as create and edit users
 * '''Page Author''' - able to edit, delete, and publish posts and pages