Kanakuk Kamps- Administrative Guide. Release 1.0. Tushar Kant 04/12/14. Chetu Inc. 1

Transcription

1 Kanakuk Kamps- HT Administrative Guide Release 1.0 Tushar Kant 04/12/14 Chetu Inc. 1

2 Table Of Contents 1. Homepage 2. Channel Content type (ex - Explore) 3. Static Page Content type (ex - Fun) 4. Transportation Location Content type (Bus) 5. Kamp Content type (ex - K2) 6. Blog Content Type (ex- Test Blog) 7. Blog Post Content type 8. I Like Kanakuk Section 9. Leadership Page & User-Profile section 10. Camp Finder Section 11. Adding & Configuring Advertisement Block 12. FAQs Categorization Chetu Inc. 2

3 1. Homepage Homepage basic details is coming from content Home Page of type homepage. For altering current homepage information: Login as admin/editor Goto sitename.com/admin/content Choose Homepage in type drop-down list. Click on edit of Home Page content. Fill in the info as below: Title - Its for internal use only. Its not going to appear anywhere in the page. Body - This is also not need. Banner: Background image - Image for homepage banner. Banner: Title - Title of the overlay placed over banner image. Banner: Body - Body of the overlay placed over banner image. Banner: Link - Link of the overlay placed over banner image. Posses two fields viz Tiltle and URL. Title will be shown as button. History: Title - History title, right after banner image. History: Body - Right after History title. Kanakuk Difference title - Title for kanakuk difference Kanakuk Difference text description - Small description of Kanakuk Difference Kanakuk Difference - Field group (Theme title, theme subtitle, theme description, testimonial comment, testimonial name, testimonial type) Testimonial picture is also there but its not used anywhere. To add more testimonials go at the bottom of the Kanakuk Difference fieldgroup and click on button Add another item. Chetu Inc. 3

4 Kanakuk Kamps - HT Activities Section contains Actitvity Title, Activities Description, Activities Learn More link, Activities Featured. For showing activities image and its title as in the image below select the activities from the Activities Featured select list (multiple selection provided). Staff Section includes - Staff: Title, Staff: Body, Staff: Learn more link, Staff: Image. Our Summer Camp Programs section. This lists 3 camps viz 1-Week Overnight camp, 2 week overnight camps and 4 week overnight camps. To add edit its items go-to Admin > Stucture > Entityqueue (admin/structure/ entityqueue). Names of the queue are self explanatory. Our Day Camp Program - KampOut! section is coming from "Our Day Camp Programs - KampOut entity-queue so as "Our Adventure Camp Programs from Our Adventure Camp Programs entity-queue and Our Family Camp Program from Our Family Camp Program entity-queue. News and Events section are coming from views named "Blog posts For Home Page (for news) and "Events for home page (for events) respectively. News shows those blog posts which are checked with "Promote to news channel sidebar and Events shows those blog posts which possess General category > Events and any one of its children viz Parties, Closing Ceremonies, Skits. Chetu Inc. 4

5 2. Channel Content type (ex Explore) To Edit Channel Content - Admin > Content, then choose Type Channel and then Apply. Click on the edit of the content type you want to edit, you can even perform a search by title. To Add New Channel Content Goto - Admin > Content >Add Content > Channel (node/add/channel). Title - title of the channel content page Body - body of the channel content page Video - Main video content. Overview Title - Title for section Channel overview Overview Description - Body for section Channel overview Banner - Displays at top of page across entire channel. Sidebar blocks - Determines which blocks go into the sidebar for this channel. Teaser View Image - This image will be shown on the teaser view of its parent page. After Overview description there are 2 side bars/regions viz "Middle Left and Middle Right. You can see whats placed inside these regions by going onto Admin > Structure > Blocks. On Channel page the middle left region possess Children teasers block (Rendered by kk_channel custom module) and the middle right region possess A test advertisement block (internal drupal Chetu Inc. 5

6 html based block). This advertisement need to be replaced with the proper advertisements of kanakuk. To manage what to display in Children Teasers block, hop over to Administration» Structure» Menus» Main menu. Here Explore is channel content type which possess first level children viz Fun (Static Page), Leadership (Static page), Safety (Channel) and Transportation (Channel). As mentioned in the above screen-shot safety and transportation further possess children and they are visible on their landing page in the Middle Left region. Chetu Inc. 6

7 Kanakuk Kamps - HT 3. Static Page Content type (ex Fun) Add Static Page link - node/add/static-page Edit previous Static Page, goto - admin/content, select Type Static Page and click Apply. Add Category: General categories and Category: Administrative taxonomy terms of your choice if not present in the list. To Add New Static Page Content Goto - Admin > Content >Add Content > Static Page (node/add/static-page). Title Body Main Image - Main image of content. Video - Main video content. File downloads - Displays as downloadable files in Resources block in sidebar. Category: General categories - Bind to a term under general category vocabulary. Category: Administrative - Bind to a term under Administrative vocabulary. Category: Free tags - Bind to a term under free tags vocabulary. In this you can enter a new tag or select from already existing from the auto-complete list. Chetu Inc. 7

8 4. Transportation Location Content type (Bus) Add Transportation location link - node/add/transportation-location Edit previous transport location goto - admin/content, select Type Transport Location and click Apply. Add Category:Year taxonomy term if not exists already. The content for this content type is fetched from circuitree api and runs as a cron job to fetch the updated data. This content type is used to show transport location for Charter Bus Cities which is located on explore/transportation/bus. All the trasport location were shown as collapsible item on this page. Transport location content type posses following fields: Title Body - Details about this location. This info is not date-specific. Address - Enter address of this location pick-up. Price Category:Year - To link this location for a particular year. Dates (field-collections - field_tl_dates) - Load time (Date and time of this pickup) & Notes (Date-specific details. Can be used to explain a sudden change-of-plans). Chetu Inc. 8

9 5. Kamp Content type (ex K2) Add New Kamp - node/add/kamp Before adding new kamp goto Structure > Taxonomy > Kamp (admin/ structure/taxonomy/kamp). And add kamp terms (if not present). Similairly add required terms inside Year, Administrative only & Activity type vocabularies. Add required Activities (if not present). (admin/structure/entity-type/ kanakuk_custom_entities/activity/add). This is a straight forward form, from here also you can tie an activity to kamp and vice-versa is also possible (means from kamp content type you can select activity/activities). Kamp content type includes following fields : Subtitle - Kamp subtitle on about kamp page Body - Body of about kamp page. Video - Main video content on the about kamp page. Category Kamp - Kamp falls under which kamp category? Category Year - Kamp falls under which year? Main Image - Banner Image shown on every tab of about this kamp page. Phone Number - Kamp-specific phone number. Directions - Text directions. Useful for printing. Location - Enter address of this Kamp. Will be used for maps. (Yet to implement Phase 2 idea ) Enroll Link - Links to enrollment URL in CircuiTree. Shown in the sidebar of kamp pages Ceremonies Title - Ceremonies section title. Ceremonies description Ceremonies image Ceremonies video Opening ceremonies title - Title for opening ceremonies section. Opening ceremonies description - Body for opening ceremonies section. Closing ceremonies title - Title for closing ceremonies section. Closing ceremonies description - Body for closing ceremonies section. Parties title - Parties section title (This whole section needs to implement, awaiting PSD) Parties video - Video for parties section. Parties image - Images for parties section. Parties description - Description of parties for this Kamp. Staff - Link staff profiles to this page. Will display in sidebar. Special experience Kamp - (If checked, this will be classified as a special experience Kamp (e.g. golf, scuba) on the Kamp Finder page - [*phase 2]) Luggage tags URL (boys) - URL to luggage tag downloadable file for boys. (Region yet to decide, awaiting PSD) Luggage tags URL (girls) - URL to luggage tag downloadable file for girls.(region yet to decide, awaiting PSD) Chetu Inc. 9

10 Featured activities - Select which activities should be promoted on About tab for this Kamp. Dates/pricing title - Title of dates and pricing section. Dates/pricing description - Description for dates and pricing section. Facilities title - Title of Facilities section. Facilities description - Description of Facilities section. Facilities (Field Collections - field_kamp_facilities) : Title - Title of facility Description - Description of facility Image - Image of this facility. Social media (Field Collections - field_kamp_social_media) : External link - Links to a social network profile for this kamp. External link class - Links class (Facebook and twitter are available for now, need to add more classes [*phase 2]) Term length prices (Field collections - field_kamp_term_length_prices) - Deprecated the use of it. We will use custom entity Kamp Term. The info for the same can only be entered when Kamp content is created. Testimonials section title Testimonials description Testimonials section image - Picture for top of testimonials tab. Testimonials section video - Video for testimonials tab. Testimonials (Field collections - field_kamp_testimonials) Name - Name of commenter. Type - Type of commenter (its a select list, if you want to add more data to this list then goto admin/structure/field-collections/ field-kamp-testimonials/fields/field_kamp_testi_type Goto "Allowed values list textarea and fill in the value and a text to be displayed, seperated by a pipe ( ) symbol. Comment - Content of testimonial. Image - Not in use. Meant to use as per specs but no specific region is provided in the PSDs. [*Phase 2] FAQ section title FAQ description - Use inline HTML design. After creating kamp content goto admin/structure/entity-type/ kanakuk_custom_entities/cet_faq and add faqs, here you can tie an faq to a single or multiple kamps. Age Range - Age range of kampers. Menu Settings: Check Provide a menu link Add Menu link title Description - Optional Parent Menu - Choose Kamp Finder. URL path settings: Default URL path will be kamp-finder/"kamp name If you want you can change it by unchecking Generate automatic URL alias Enter preferred URL alias, remeber it should starts from kamp-finder/ Other fields are optionals. Hit Save Chetu Inc. 10

11 You will now be redirected to the page view of the Kamp just created. Click on the Edit button. Go at the bottom of the content section till you will find a URL redirects tab. Click on it and then click on Add URL redirect to this content. Copy whatever value is inside To textbox. It should be of format node/nodeid (ex node/3234). Paste this value inside From textbox. Now change value inside To textbox to node/node-id/about (ex- node/3234/about). This need to be done so that when user clicks on a particular camp he will be internally redirected to kamp/about page. Term length prices (Shown in Availabilty & Pricing tab of kamp) Goto admin/structure/entity-type/kanakuk_custom_entities/ cet_kamp_term/add Title - For administrative purpose/ to distinguish between other kamp terms. Term ID (name) - Kanakuk-generated term name/id. Kamp - Select the newly created kamp above. Or even you can select other camp to show this term length in its Availability & Pricing section. Category: Term length - How long is this Kamp (1, 2, or 4 weeks)? Date Range - Date range for this term. Genders allowed - Which genders are allowed at this term? Options are Boy, Girl (one, both, or neither can be selected) Closing ceremonies: Pick- up - Description for picking up children for closing ceremonies. (Not in use anywhere. [*Phase 2]) Closing ceremonies: parking - Description for parking for closing ceremonies. ([*Phase 2]) Closing Ceremonies: Schedule - Use below fields to define the set of closing ceremonies activities. ([*Phase 2]) Events ([*Phase 2]) Price - Kamp Specific Prices Category: Year - Belongs to which year. Enroll link - Enroll link for the referenced Kamp Chetu Inc. 11

12 5.1 Screenshots of where Kamp Content Type inserted data is shown. About Page Chetu Inc. 12

13 Facilities Page FAQs Page Chetu Inc. 13

14 Kanakuk Kamps - HT Testimonials Page Chetu Inc. 14

15 Chetu Inc. 15

16 Availability & Pricing Page Chetu Inc. 16

17 Kanakuk Kamps - HT To and From Kanakuk Page (Ceremonies) Chetu Inc. 17

18 6. Blog Content Type (ex- Test Blog) /node/add/blog Blog content type consists of following fields : Title Body Main Image - Main image of content. Will apply as banner. Video - Main video content Category: Administrative Sidebar Blocks - Determines which blocks go into the sidebar for this blog. Social Media - Use the following fields to include social links for this user (not utilizing any social media fields right now[*phase 2]) Social media: External link - Links to a social network profile for this user. Social media: External link class - Class for this link. Determines which social network icon to use. All other settings are optional, by default all blogs (only title and more link to that blog) with their 5 latest blog posts are shown on news page. Chetu Inc. 18

19 7. Blog Post Content type node/add/blog-post A blog post can only exists if a parent blog is present. If not, then please create one as mentioned in previous topic. Blog Post content type consists of following fields : Title Body Blog - Ties this blog post to a blog Main image - Main image content Video - Main video content. Resources For - Links to related resources. Includes title and URL. May link to external resources. Author - Useful for assigning content to real user instead of web content editor. Category: Kamp Category: Term length Category: General categories Category: Administrative Category: Free tags Promote to news channel sidebar - Should this item appear in Blog posts block on News channel sidebar? Breadcrumb Parent - Choose the blog to which this blog post refers to. This field is used to manage breadcrumbs. Chetu Inc. 19

20 Chetu Inc. 20

21 Chetu Inc. 21

22 8. I Like Kanakuk Section This is simple form which is coming from EntityForm Testimonial. Entityforms are available at admin/structure/entityform_types Admin/Editor can view all the submissions of ilikekanakuk at admin/structure/ entityform_types/manage/testimonial_form/submissions To edit What is I Like Kanakuk As admin mouse over on the corner of What is I Like Kanakuk you will see bolt like icon click on it and select edit view. Chetu Inc. 22

23 Next screen will be of edit view section. Here click on Global: Text area. You are now on edit Global: Text area screen. Here edit the contents inside the HTML tags (viz h2, p and div ). Please don t delete these tags since these are used for the styling purpose. Chetu Inc. 23

24 9. Leadership - The Kanakuk Team Page This page is of static page content type. The main section of this page are the Executive Team and the Kamp Directors. Executive Team is using the entity queue Executive team. To add/edit more users to this queue just go to - admin/structure/entityqueue/list/ executive_team/subqueues/5/edit. Add users by using the auto-complete textbox, and clicking on the Add item button. Add as many users you want and in the end click on Save button. To remove any user from the list just click on the Remove button. Don t forget to save after removing users. Camp Directors is using the entity queue Camp directors. To add/edit more users to this queue just go to - admin/structure/entityqueue/list/ camp_directors/subqueues/6/edit. Add users by using the auto-complete textbox, and clicking on the Add item button. Add as many users you want and in the end click on Save button. To remove any user from the list just click on the Remove button. Don t forget to save after removing users. User Profile Page: User profile page consists of following fields : First Name - User s first name. Last Name - User s last name. Nickname - User s nickname. Job title - Attach user to a job title(s). Profile picture - User s profile picture. Alternate picture - Alternate image, such as employee s family. Uses picture s title as caption on staff bio page. Pull quote - Pull quote to display on staff bio page. Video - Main video content. SOCIAL MEDIA : External Link - Links to a social network profile for this user. External link class - Class for this link. Determines which social network icon to use. Staff type - Tag user to the type of staff position. Public bio - If checked, user s staff bio page is publicly available, and user appears on Leadership landing page. User Bio Gender - not shown anywhere else, just for future refernce if admin wants to see all male/female candidates. Chetu Inc. 24

25 Chetu Inc. 25

26 10. Camp Finder Section This is very powerful page, since it picks data from Kamp content type, Term Length - taxonomy term, Kamp Term - kanakuk custom entity and some additional code has been written for certain arithemetic calculations. This page is of Static Page content type. We are just using its Title from that node (node-id : 36). The first section of this page is Most Popular Term Lenth block. Its rendered via view - most_popular_term_length. This block will show the term length whose Most Popular checkbox is checked. To add/edit this block information, hop over to : admin/structure/ taxonomy/term_lengths. Here you will get the list of the terms present in the system, basically taxonomy term which is named as term length. Right now 2-week term posses the most popular term field checked. Simply click on edit of it, and add/edit details over there. Fields for taxonomy term - Term Length : Name - Name of term length. Description - Decription of term length. Tagline - Tagline of the term length Image Promotional body - Will be shown in Most Popular Term Lenth block body. Promotional picture - Will be shown in Most Popular Term Lenth block image area. Most Popular - Check if term length has to be shown in most popular term length block. Chetu Inc. 26

27 Overnight Kamps Section: Rendered via Term length description block This is section is utilizing the Term Length + Kamp Term & Camps related to that term data. The different blue bars shows under this section shows the Title - Tagline info of the term length taxonomy term. As we can associate multiple camps to a term and same kamp can have multiple term so we got duplicates in that case, that s why conditions have been added in the code to not include duplicates. Guidelines to insert Kamp Term custom entity: Goto : admin/structure/entity-type/kanakuk_custom_entities/cet_kamp_term Here you can add/edit kamp terms Fields details of kamp term: Title : internal use only, to differentiate between different kamp terms. Suggested title syntax will be: Kamp-name term-length Term sequence-no. Term ID (name) : Kanakuk-generated term name/id. Kamp : Which Kamp does this term apply to? Category: Term length : How long is this Kamp (1, 2, or 4 weeks)? If its set to suppose 4 weeks then the referenced kamp and its info will be shown inside the 4-week - Adventure blue bar. DATE RANGE - Date range for this term. Genders allowed - Which genders are allowed at this term? Options are Boy, Girl (one, both, or neither can be selected) Closing ceremonies: Pick- up - not being utlized any where Closing ceremonies: parking - not being utlized any where CLOSING CEREMONIES: SCHEDULE - Use below fields to define the set of closing ceremonies activities. Not being utlized any where. EVENTS - Activities for that time range. Not being utlized any where Price - Kamp specific prices. This price will be shown in the Price column. Category: Year Enroll link - Enroll link for the referenced Kamp. This will be used as the Text +link of the green enroll button inside the description of the term length. Chetu Inc. 27

28 Specialty Kamps Section: This section will show the info related to the kamps whose Special experience Kamp is checked. All the special experience kamps will be shown in a different blue bar under this section. This picks Genders, Enroll Link and Price from Kamp Term (Custom entity), And Ages, image, description from Kamp content. Chetu Inc. 28

29 11. Adding & Configuring Advertisement Block Goto admin/structure/block/add Give it a title if you want to show that on the page else put <none> Give it a description, this is a required field and it will be used to ditinguish this block between other blocks on the blocks configuration page via admin. Block Body : Enter the contents like a hyperlinked image. Region Settings : Select a reigion to show this block in. Go over this link to see the different regions available on the site and its positioning - /admin/structure/block/demo/kanakuk Visibility Settings - The tricky part lies in here: Pages: This first option allows you to display your block on specific pages of your site. It requires you to enter the path to the pages on which you do or do not want the content to appear. Before you can enter paths in here, you need more pages on your site. Content Types: This option allows you to display your block on pages that display information of a certain type: Article, Basic Page, Blog, Blog post, Channel, Homepage, kamp, Static Page and Trasportation Location. Roles: If you want to allow only registered users to see your block, this is where you control that. Leave everything deselected if you want both signedin and guest users to see your block. Users: These settings control whether registered users can choose to hide a block from view when they visit pages on your site. The first option gives them no control. The second lets them hide the block, but it is visible at first. The third lets them hide the block but lets them show it if they wish. If you let them control the visibility, a check box with the block name will appear on their My Account Edit page. Chetu Inc. 29

30 12. FAQs Categorization To add a topic and associate a FAQ with the same: Goto admin/structure/taxonomy/faq_topics, here you can add/edit/delete the topics. To associate FAQ to a topic, goto admin/structure/entity-type/ kanakuk_custom_entities/cet_faq Click on edit of any of the FAQ At the end of the form you will find a Topics dropdown list, it will list the topics you had entered in the first point. Select any one of them and changes will be reflected over FAQs page, as well as Kamp section FAQs page. List of topics are sortable using drag and drop interface on page admin/structure/ taxonomy/faq_topics List of Questions are sortable via custom drag and drop interface on page admin/ config/kanakuk_faqs_reorder Chetu Inc. 30