FAQs Extension Installation

Contents

System Requirements

Top

Installation Instructions

  1. Log into the Admin section of your SkyBlueCanvas site at www.yoursite.com/admin.php.
  2. Navigate to Admin > Collections > Installer.

Top

About FAQs

The FAQs Extension allows you to add a Frequently Asked Questions section to your site. The manager allows you to group questions based on topic. For instance Company Info, Product Details, etc.

Top

FAQs Fragment

Fragments are bits of code that output the HTML for a portion of a web page. Many times the fragment will be associated with some data item (for example FAQs). It is important to keep in mind, that it is impossible for any single piece of software or code to meet the needs of every user or every web site design.

While we have done our best to design SkyBlueCanvas so that it can be customized with "minimal" coding, it may still require "some" coding. Customizing the appearance of your FAQs may require some modification on your part to the fragment code.

Top

The Fragment HTML

The FAQs fragment HTML is structured to allow you to easily customize the appearance using CSS (cascading style sheets) and JavaScript. The basic structure is:

<div class="faqs-group">
    <h2>The Group Title</h2>
    <h3 class="faqs-question">
        <a href="#answer1-1">What is your quest?</a>
    </h3>
    <div class="faqs-answer" id="answer1-1">
        <p>To find the holy grail.</p>
    </div>
    <h3 class="faqs-question">
        <a href="#answer1-2">What is your favorite color?</a>
    </h3>
    <div class="faqs-answer" id="answer1-2">
        <p>Blue. No, Green. Aaaaahhh.</p>
    </div>
</div>

Instructions for styling and behaviors using CSS and JavaScript are beyond the scope of this document.

Top

Displaying FAQs on Your Site

There are two methods by which you can display FAQs on your site. The first is to create a skin specifically for the FAQs. The second is to load the FAQs in the article body of a page using the default skin.

FAQ-specific Skin

To create a skin specifically for your FAQs, make a copy of your default skin and name it skin.faqs.html. In the region of the HTML where you want your FAQs to appear, add the following code:

<!--#plugin:fragment(faqs,view)-->

So your template HTML might look like:

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" 
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" {doc:lang}>
    <head>
        <title>[[page.title]]</title>
        <meta http-equiv="Content-Type" content="text/html;charset=UTF-8" />     
        <?php echo $this->get_meta_data(); ?>
        <link rel="stylesheet" type="text/css" href="<?php echo $this->get_path(); ?>css/TechJunkie.css" />
        <link href="[[site.url]]rss/" rel="alternate" type="application/rss+xml" title="[[site.name]] RSS Feed" />
        <!--#plugin.preloader-->
    </head>
    <body id="homepage">
        <div id="wrap">
            <!--#plugin:fragment(header)-->
            <div id="menu">
                <!--#plugin:fragment(menu,view,menu=1)-->
            </div>                    
            <div id="content-wrap">
                <div id="main">
                    <!--#plugin:fragment(faqs,view)--> 
                </div>
                <div id="sidebar">
                    <!--#plugin:fragment(sidebar)-->
                </div>        
            </div>
            <div id="footer-wrap">
                <!--#plugin:fragment(footer)-->
            </div>
        </div>        
    </body>
</html>

Next, create a new page in Admin > Pages. On the Meta Tab of the page editor, set "Layout Type" to "FAQs".

Page Article Method

To display your FAQs in the article text of the page, go to Admin > Pages and click the Edit icon next to the page to which you want to add the FAQs. In the article body of that page, add the following code:

{plugin:fragment(faqs,view)}

Top