Editing site content

This section contains a number of pages describing how you should edit content on this site.  It is the source of tutorial information for the new volunteer and also contains descriptions of how to do some of the trickier editing that even experienced content editors may need to reference from time to time.

General Guidelines for All Authors and Editors

An Introduction to Editing Content

Click here for a step-by-step basic introduction to how-to add content

Using the TinyMCE Editor

When you edit a field that allows rich text in rich-text mode, you use the TinyMCE editor.   We have not been able to find a good user guide that describes TinyMCE, so the best way to learn its features is to mouse-over or click on the icons that are displayed at the top of the edit block.  However, the following draft user guide does provide some information that may help you: Moxie draft user guide

For important hints from our volunteer editors on editing rich text on the site, please read Rich Text, Plain Text and the TinyMCE Editor.  It may save you rework if you do!

Guidelines for Various Content Types

If you have been assigned a task involving any of the content types below, you can find specific instructions on what to do when creating or editing content on the following pages:

 

In addition, there is information about some of the trickier procedures one may need to follow:

 

Ad specifications

160px wide is the max, height is open, but standard IAB web ad sizes are: 160x600 and 120x600 for vertical "skyscraper ads".

Make either a gif or jepg.


Rich Text, Plain Text and the TinyMCE Editor

  • Rich Text Format (often abbreviated RTF) is a WYSIWG (what-you-see-is-what-you-get) document format that can be read and written by most word processors, such as Microsoft Word. The editor our site uses to create rich text is called TinyMCE (Tiny Moxiecode Editor).
  • You may enable or disable rich text in content boxes throughout the site. You may also enable or disable it by default from the Edit tab your your user account settings. Disabling rich text will speed up the load time of all Edit pages but does not prevent you from enabling it in the content box you are working on.
  • The icons shown in the rich text editor are very similar to those seen in other word processors. Hovering your mouse over each icon tells you what it does.
  • There are a limited number of Formats to choose from. Experimentation is the best teacher. What you see isn't always quite what you get.
  • Caution: Do not paste from Word with the "W" icon unless you are willing to clean up a lot of messy code. Use the "T" icon to paste plain text. Pasting from Word or other web pages is ok. Do your formatting after you paste content or create your content directly in the content box without any pasting.
  • Warning: Do not edit text containing PHP code using rich text mode!  Simply turning rich text mode on then off again can corrupt the php -- you don't even have to touch the text! If you see the string <?php in the text block, it contains PHP code.
  • It is easy to go back to your previous work. Just click the Revisions tab at the top of each page. Revert to an earlier version as needed.

Adding Pictures in Rich Text Mode

The system allows photos only up to the following size:

Limits: File size = 100 KB, Dimensions = 500x500, Quota = 206.4 KB/500 KB

Browse to your photo, upload, then click Add to insert into the edit box.

If you want to have space around it (offset from text) go to the Appearance tab, select Vertical and/or Horizontal spacing and play with the amount (try starting with 10).

About Breadcrumbs

Breadcrumbs are the hints about how this page was reached that you find in the green bar at the top of the middle panel on each page. Breadcrumbs are fairly broken in Drupal V5. Our software contractor did a couple of patches for panel pages and views which Drupal didn't handle at all.

However there are two types of people in the world, back people and non-back people. I am a back person. I always navigate by hitting the back button and going back to where I was last when I hit the end of a string of forward motion. So for me a breadcrumb trail of where I have been makes the most sense. Non-back people always navigate by going forward following links they see on the screen. For them a breadcrumb trail that shows the logical path to a page is better. This is in general hard to construct because webs are webs, not strict hierarchies, and pages have multiple logical ways of getting there.

If you arrive at a page from some external search engine there is not enough information to construct any useful breadcrumb. Thus it is good for most pages to have some links within the content portion that lead to other related pages, typically higher in the tree, so that people who arrive from a search engine know a little bit about how to find this page by site navigation, for example, in the donation tree, the Donate Now page needs a link to back to the motivation page, just as that page needs a link to Donate Now.

About the Site URLs

In a nutshell, the URLs are created when you create a page and if the creator takes no special action they are assigned a name based on the Title of the page. Either at creation time or later you can change the URL by editing the page BUT one must be very careful because there may be links to it under the current URL and you will break all of those links.

All pages have a content type the simplest being Page which has little more than a Title and a Body. The Hike content type has a lot more fields. When you create a page with some content type the first component of the path is the content type, thus the URLs of all the hike pages begin /hike/…. And plain pages begin /content/…, etc.

One needs to take care when creating pages for a new content type to select the appropriate page type.  For example,

news items begin /news/… but the head page /content/news-trail-conference should probably have been created as a panel page instead of a plain page. Panel pages enforce a certain uniformity of layout while plain pages pretty much allow anything you can do in html in the “content” area.

Adding PDFs

To add a PDF to a Page (when creating or editing a page):

1. Go to Create Content.

2.Scroll down to Paper Forms

3. Fill in the fields as needed (many can be left blank)

4. Scroll down to File attachments

5. Browse to find the file you want on your computer

6. Click Attach

7. Click Submit

8. Copy the url of this pform page, then return to your page and create the link to this page. (Revisions to forms can henceforth be added to the pform page without needing to change links to it.)

 

Adding images

1. Log in by entering your user ID and password.

2. Find the hike/park that you want to add the picture to, and then click on it. If you are properly signed it, when the hike comes up on the screen, there should be a series of small boxes just below the title of the hike. Click on the second box, which says "Edit." After a while, the "Edit" screen will appear (this could take time).

3. Scroll down until you see the word "Picture." Below that, it says "Upload a new image," and to the right of that, there is a box that says "Browse." Click on that box, which links to the files on your computer. Click on the various entries until you reach the picture that you want to add to the site. Then click on the picture to add it to the page.

4. Click the box on the line below that says "Upload." When you do this, wavy lines start moving through the box on the line above. When the wavy lines stop, the picture itself will appear, with its title to its right. At this point, the picture has been successfully uploaded.

5. You then must save the changes by scrolling to the very bottom of the page and clicking on the "Submit" button. That completes the operation, and once the website has processed the change, the updated page with the picture will appear on the screen.

6. Note: Sometimes, you will get an error message that appears in pink. It contains some kind of incomprehensible gibberish, often to the effect that you don't know how to use grammar or syntax, and that you need to read some kind of obscure user manual that you never heard of. If this happens, and the picture was not saved, just start over again. If the picture was successfully saved, you can ignore this nonsense.

Adding links to a page

When adding a link to text on a page, have the link open in a new window if it takes the viewer outside the nynjtc.org site.  Do this by creating the link using the rich text editor for the field containing the link and setting the Target field to "Open in new window (_blank)".

If the link is within the site, have the link open in this window/frame.  (This is the default.)  If you have to modify it, edit the link using the rich text editor for the field containing the link and set the Target field to "Open in this window/frame".

Note that fields that are defined as link URL fields (e.g., the Park Link URL field in the Contact section of the Park page) have the open properties pre-set.  You cannot change them for a particular page.

By following this convention, we improve our Web usage statistics and keep people on our site longer.

Code for Special Formatting of some blocks and green rules

To add a dark green bar at top of a light green block (see Trail Mix on home page):

Can only be done when adding a block to a pane on a panel page (eg, home page)

  • Click Override title and type in desired block title for display
  • in the field CSS-class (below block body): type: todays-highlights
  • Save block and panel

 

To add a dark green bar at top of a light brown block (See HOTW)

Can only be done when adding a block to a pane on a panel page (eg, home page)

  • Click Override title and type in desired block title for display
  • in the field CSS-class (below block body): type: search-for-hikes
  • Save block and panel

 
To add space top and bottom on green rule around white headline (H2 in TinyMce) as in Scheduled Hikes, type code before and after text as follows around "Sunday, January 17":

  • <h1 class="scheduled-hikes">Sunday, January 17</h1>

Editing Workshop and Course descriptions

http://www.nynjtc.org/view/workshops:
This is an automatic table that is created from info put in as ‘Workshop' content type; i.e., you can't manipulate directly on this page but only by making changes to particular workshop content. Click on the name of the workshop in the table, then the edit tab at top; the database fields pop up and you can make content changes here. Hit submit at the bottom to save your changes. They will automatically show up on the webpage table.

If you want to hide a workshop listing, click on Publishing options near the bottom of the data page, then uncheck the Published box. I believe it will not show up. (I have not tested this-let me know if it doesn't work.) The benefit of hiding, is that you could later publish the same workshop, after making appropriate changes, by re-clicking Publish.

If you want to delete a workshop listing, you need to delete the data page for it. Click delete at the bottom. Note that deletions are irreversible-you have to start from scratch if you make a mistake.

If you want to add a workshop listing, select Create Content then "workshop" in list of content types. Then fill in the fields.


http://www.nynjtc.org/coursecatalog
:
This also looks to be an automatically created display compiled from ‘Course content' types. To edit existing descriptions, click on the course title, then the edit tab at the top. Make your changes in the appropriate box. (see directions for workshops above).

If you want to hide a course listing, click on Publishing options near the bottom of the data page, then uncheck the Published box. Etc as in workshops above.

If you want to delete a course listing, you need to delete the datapage for it. (Click delete at the bottom. Note that deletions are irreversible-you have to start from scratch if you make a mistake.

If you want to add a course listing, select Create Content then "Course" in list of content types. Then fill in the fields.

http://www.nynjtc.org/content/trail-university
Editing this page involves just editing the content that you see. The links are to the pages discussed above and so the directions above apply. Do you want to change particular content on this page?

Guidelines for authors and editors of Region, Hike and Park descriptions

General Guidelines

  • Be familiar with basic editing procedures on this website. They are outlined in an introductory presentation: click here to access the pdf.
  • There are a number of content types. Each contributes to creating a database comprising a category of information. The category is typically indicated by the first word after the first slash after org. Examples: a database of hike descriptions (www.nynjtc.org/hike/hikename), a database of park information (www.nynjtc.org/park/parkname), a database of regional information (www.nynjtc.org/region/regionname) general information (www.nynjtc.org/content/pagename--'content' is the non-specific database of info.)
  • Databases vary in their complexity.
  • Not all fields in each database display on the public web page.
  • Not all fields in each database are currently used.
  • Below, we outline the procedures for completing a description in the Parks database and the Hikes database. Generally, the principles are tranferrable to othe content types.
  • The display of fields does not necessarily follow the order of fields in the database.
  • From time to time, new fields may be added, renamed, removed, or their content changed.

Guidelines for Park descriptions

Park Name (plain text)

Use the exact park name that is used in primary sources such as the Walk Book and official governmental sites. If there is an alternative name or an alternative spelling, include that in brackets.

Park Map

See Hints for Placing Google Maps on a Page.

Park Photo

The photo block is 300 dpi x 300 dpi. Things work best when the photo is scaled and cropped to that size before uploading it. (Drupal does not always insert photos scaled or at the correct size.)

Park Description (rich text)

There is no length limit, but keep in mind that visitors do not like to do too much vertical scrolling. Enter bullet points, indentations and links using the icons you see when rich text is enabled.

Trails Overview (rich text)

You need not include every trail in the park. Give an overview and then hit the highlights.  Use Italics to identify the trail name and follow its initial mention with [XX miles; blaze color], e.g. [20 miles; red] . You may include directions to trailheads that are not covered by the main directions to the park.

Park Overview (plain text or rich text)

This is the teaser. Keep to around 30 words or less.

Directions

Googlemaps can be helpful as well as the Walk Book and other primary sources. Remember, people can be coming from anywhere. Use the full spellings of terms such as, "route" and "street". Specify if the road is a State Route or a US Highway.

Include links to public transportation schedules wherever possible.

Nearby Parks

Select from the dropdown list after entering the first few letters of the nearby park name.

All Trails in Park

In a later phase of site development there will be links to all the trails. For now, leave this blank.

TC Book

If the park is described in either the New Jersey Walk Book or the New York Walk Book, select the appropriate one from the dropdown list.  Note: on this dropdown, as with all of them, several taps of the key for the first letter of the name will take you quickly to the proper selection. 

TC Map

If we publish a map, select it from the dropdown list.

Web Link Title and Web Link URL

Enter the name and the URL for the external link for the park.

Phone

Enter the phone number for the park or park manager. Use the format  ##########.

Walk Book Region

From the New York Walk Book or the New Jersey Walk Book.

Physiographic Region and Tourism Region

Not currently being used. Leave blank.

State

From the dropdown.

County

From the dropdown.  Here again use several taps of the key for the first letter of the county's name to locate it easily.

Municipality

From a primary source.

Trail Uses

Check all that apply. 

Trail Miles and Acres

Usually available from primary sources. Our cartographer will help, but  asks that requests be summarized into one list. Leave such requests as comments to this page.

Dogs

Usually available from primary source.

Fees

Leave blank unless you are sure that there is never any fee. You may include fees in the Park Description, if you know what they are, but leave out references to specific dates when fees are charged. "No fees in winter. Check with Park for other seasons." is ok. The Web Committee is still formulating the dropdown choices for this field.

Modified By and Last Update

Not necessary to fill in. Use the Track tab to see who edited the page last and when he or she did it.

Management

Leave Blank except for Landowner, which may be selected from the dropdown.


Guidelines for Hike descriptions

Note: To add a hike to the database, you must be approved as a Trail Conference volunteer content provider. To inquire about volunteering for this position, please click on Volunteer Now in the left column and complete the Volunteer Survey form. Thank you.

HIKE DATABASE

Title: Give a unique title for the hike. Titles are used by Search engines, so include trail names, park or region, or feature that people might look for in a search.

Historic: Leave alone for now.

Publication Date: Date description first published. If description is appearing first on this website, then choose date that it is being entered.

Length: Distance of hike in miles

Route type: Choose from drop-down options

Time: Approximate time to hike the distance. Generally assume about 2 miles/hour pace, unless very strenuous.

Dogs: Choose from drop-down options

Difficulty: Somewhat subjective; choose from drop-down

Picture: Upload a photo, 300 dpi x 300 dpi. Things generally work best when the photo is scaled and cropped beforehand. Enter alternate text and Title (can be photographer, as there is no field for this elsewhere)

Features: Check all that apply. (Fees most often are parking fees. Relevant notes about fees may be made in the body text, though do not cite specific fees or dates, as these are subject to change and can quickly be out-of date. Folks can find this info on official websites, which we include.)

Teaser: 25 words or less

Sponsor: leave blank

State: checkappropriate button

Region URL: type first few letters (Regions are based on Walk Book regions), region names will pop up; select correct one. This provides a link to our web page for the region

Region: Choose from drop-down 

Park URL:  type first few letters; park names will pop up; select correct one. This provides a link to our webpage for the park

Parking Map: this field is for Google code to identify as close as possible the parking area for the start of the hike. See Hints for Placing Google Maps on a Page.

Park: Type in name of park

County: Select from list

Web map title and web map URL: Provide these for trail maps that can be downloaded from other sites, ex, park websites.

Buy Trail Map: Select appropriate TC map if one exists for the hike area

TC Map: Select specific TC map appropriate for hike

Sketch Map: skip this field

Other map: Generally skip this field

KLM file title and URL: skip these fields

Buy Book: Select appropriate book from drop-down. If in doubt, either the NY or NJ Walk Book is usually a good choice.

Turn-by-turn description (enable rich text):  Just the facts, in a list

Description (enable rich text): The main text that describes the hike. Be sure to note all trails and turns, major features, any cautions (tricky route, rough treadway). 
  • Select Enable Rich Text at bottom of box.
  • If you are copying text first developed elsewhere, select the icon that shows a clipboard under the letter T. A box will pop up; copy your text here, then insert into the description field. Format using  Bold and ital as appropriate. 
  • Our style is flush left, including first lines of paragraphs, with a line space in between each paragraph.

Reference/Source: Name of newspaper, book, or other source if relevant (ie, if description was published elsewhere first)

Report title and URL: skip these fields

Driving Directions (enable rich text): Give from nearest main road. Walk Books are a good reference, as is Google Maps.

Train (enable rich text): Fill in if appropriate with station stop and train line name. Can include link to train line (find links at http://www.nynjtc.org/content/public-transportation-links

Bus (enable rich text): Fill in if appropriate with station stop and bus line name. Can include link to bus line (find links at http://www.nynjtc.org/content/public-transportation-links

Log message: Generally leave blank

Remaining fields: Generally make no entries; leave URL path settings checked for Automatic Alias.

Click Submit and the hike is added to the database. (You may want to submit periodically as you work to be sure you don't lose your work in the middle.)

 

Hints for Placing Google Maps on a Page

Create a Google Map (iframe)

Revised by [email protected] 10/21/2011

  1. Read directions to find some place relatively near the trailhead to use as a starting search in Google.
  2. Go to http://maps.google.com/maps and create an account, if you don't have one. In your account profile, change your nickname to "TC Volunteer".
  3. Enter the most specific location for the park/hike that you know of and Search Maps for that location.
  4. Click on the marker in the left column to bring up its baloon description in the map. In the bottom of that description, click on the "Save to Map" link.
  5. Save will take you to My Maps.
  6. Choose Create a new map and Save.
  7. Click on My Places.
  8. Click on the map you just created.
  9. Click on Edit.
  10. Edit the map Title, Description (suggested to leave blank) and Place details (suggested to leave blank).
  11. Choose the "Unlisted" radio button. This will prevent your map from being visible to the casual web user without first going to our site.
  12. Use zoom and probably satellite view to put the right spot in the center of the window
  13. If the baloon represents a known point of interest, rather than your trailhead, you may or may not want to delete that balloon and replace it with one of your own choosing. To do thisclick on the baloon in the map and Delete in the lower left corner. Then plae and ttle your own baloon.
  14. Place addition markers as required. Some parks are very close or even adjointing to each other In such cases you may wish to make one map covering more than one park.
  15. Use the "Collaborate" link to share your map with [email protected]. Allow Collaboratores to invite others, but do not Allow anyone to edit this map.
  16. Click Save and/or Done. Log out of Googlemaps.
  17. Log back into Googlemaps and access the map you are working on using My places..
  18. Clink on the Link symbol near the upper right corner of the map.
  19. Then on the "Customize and preview embeded map" link.
  20. Map will pop up in a new window, Select custom size and set it to 300x300
  21. Readjust the centering and zoom level; select Satellite view
  22. Log out of Googlemaps main window. This will still leave the pop-up window open.
  23. Click in the HTML code and type CTRL A, CTRL C to select and copy the code.
  24. Go to your hike/park map, make sure that your input format has Full HTML selected and that you have disabled Rich Text.
  25. Type CTRL V to paste the code into the map box (in Hikes database, paste into Parking Map box).
  26. So that “View Larger Maps” links all open a new tab in either IE or FF, insert target="_blank"   just before style="color in the last part of the HTML expression. Note the placement of the quotation marks. Edit a park page like Buttermilk Falls to see an example.
  27. Submit the hike/park and admire your work.
  28. If it doesn't look right, go back to your Google window and adjust and replace the html.
  29. Save your Google Map. Close the Google Map new window but, if you are going to do another map, don't close your Google My Maps tab unless you have a problem. If you do run into a problem, close My Maps, log out of Google and log back in.

 

 

-

 

Official Site Colors

The following colors should be used for zebra striping in tables and as background colors: Dark: dbdba4 Light: eeefd8 Occasionally, for headline bands at top of boxes Dark Green: 2e8b57