This is an old revision of the document!


Site Configuration

The conf/site.php contains all your parameters.

This is a php file that contains an array of string variables

Site Configuration File

All of your settings are normally read from the conf/site.php. But while your site is in production (live), you might want to edit settings “offline” to test new features (not showing these pages to your visitors).

In such cases, you may add “?dev=1” to any of you website's URL in order to use an alternate configuration file. In this case, the configuration file used would be conf/site_dev.php instead of the regular conf/site.php.

Basics

All configuration parameters are stored in the $pvw_conf array, like this :

$pvw_conf['site_name']	="YourCompanyName";
$pvw_conf['baseline']	="We are the best";
$pvw_conf['navbar_width']	='2';
$pvw_conf['emails']['support']	="me@domain.com";

Default Settings

if not set or empty, most setting values (except “id”, “site_name” and “baseline”) are automatically filled with predefined default values.

Example: if you set 'navbar_width' to '2', the '2' value will be used. If you ommit this, the default value of '1' will be used.

Check current Values and Descriptions from Private

You may list all parameters and their current values (set by you or by default) from your Private area located in the Web menu and the Hosting Configuration tab at http://private.plugivery.com/web/#tab_web_pvw .

Each parameter effect is clearly explained within that page.

Contact Emails

are stored in : $pvw_conf['emails']

If a visitor uses the contact form to reach a certain department on your website such as “customer support” or “general inquiries”, his message will be sent to the email addresses set as :

$pvw_conf['emails']['general']	="me@domain.com";
$pvw_conf['emails']['support']	="my.support.dept@domain.com";

Widgets

Are stored in : $pvw_conf['widgets']

Wigets are snipsets of code (mainly external) that provides extra features for your website. By default, they are all deactivated. Here is the list of all available widgets :

  • share : Adds a well known “Share” widget printed on the left or right side of the page.
  • share2 : Same as the “Share” widget but it is located inside of the page, near the title.
  • share_news : Is an other “share” widget that allows to share news individually instead of the whole News listing page. It is printed near each News title within the News view.
  • follow : Adds a “Follow” widget printed on the top of the page.
  • fb_like : Is a Facebook “LikeBox” that can be inserted within Boxes.

Set each widget's parameter to 1 to set it's status value to 'on'. Set your own parameter value to override the widgets default value.

In example : To active the share widget, with 10 icons (instead of the default value of 5), simply add :

$pvw_conf['widgets']['share']['on']			=1;
$pvw_conf['widgets']['share']['numPreferredServices']   =10;

Sections

are stored in : $pvw_conf['sections']

The site is organized in sections listed in the navigation bar at top (navbar). Possibles sections are:

  • home contains the home page only.
  • products can contains these pages:
    • software : a list of all your software
    • bundles : a list of all your bundles
  • news can contains these pages:
    • blog : a news blog for posting news, updaes, releases, etc..
    • videos : all your latest YouTube Videos
    • facebook : an external link to your Facebook Page
    • twitter : an external link to your Twitter Page
  • support can contains these pages:
    • faqs : an FAQs list page build from your FAQS configuration file
    • forums : an external link to your Forums
    • downloads : a download center with all your latest versions
  • about can contains these pages:
    • company : a description of your company
    • press : a page intended for media companies, containing your latest presse releases and medias materials to downloads
    • contact : a contact form

Each sections can be activated or not and will be sorted in the order defined in the 'sections_on' array. If this is not set, all sections will be displayed. Example:

$pvw_conf['sections_on']=array('home','products','about');

Each section has her own parameters, that as always get default values that you can ovveride using the site configuration (See your Private page to see their current values). For each section you can set:

  • menu_name : Name shown in the Navigation Bar
  • title : title of the section (visible in the section Index)
  • html_title : Browser's window title of the section (visible in the section Index)
  • meta_desc : Meta “description” tag content
  • meta_keys : Meta “keywords” tag content

Example:

$pvw_conf['sections']['about']['menu_name']   ="About MyCompany";
$pvw_conf['sections']['products']['meta_keys']="software,audio,vst,plugins,rtas,music";

Pages

are stored in : $pvw_conf['pages']

Each sections can contain one or more pages, defined and sorted according to the 'pages_on' array indexed by sections. By default, all factory pages are shown, bu you can limit it to the page you want, by setting the pages_on of each section.

Example :

$pvw_conf['pages_on']['news']=array('blog','videos');
$pvw_conf['pages_on']['about']=array('company','contact');

Notice that if a section contains only ONE page, the section will be replaced by this page

Each pages has the following parameters (set by defaults, overriden by you) :

  • title : Title of the page
  • html_title : Browser's window title
  • intro : a short text displayed in the section index, under the title of the page
  • menu_name : the name of the page displayed in the Navbar menu
  • fa_icon : another icon to diplay in the various menus
  • meta_desc : Page meta “description” tag content
  • meta_keys : Page meta “keywords” tag content

Example:

$pvw_conf['pages']['about']['contact']['title']       ="Contacting MyCompany";
$pvw_conf['pages']['products']['bundles']['meta_desc']="All bundles made by Mycompany";

Custom Pages

If you need to create others pages, you can define them with any HTML content you need. You just have to create the page definition in the pages array, and enable it in the pages_on array of the corresponding section.

Example:

$pvw_conf['pages']['about']['our_jobs']['title']       ="Jobs at MyCompany";
$pvw_conf['pages']['about']['our_jobs']['content']     ="We are hiring a cool developper";
 
$pvw_conf['pages_on']['about']     =array('company','our_jobs','contact');

In this example we created the our_jobs page, linked from the about section at the url /about/our_jobs.

Note: the page index name (our_jobs in the example) must NOT be one of the factory page, else it would be ignored. Therefore as we will regulary add new factory pages with some unique index name, we advice you to choose an index name that will never match one of the future factory page name. Prefixing it my your company name or with custom_ (or our_ like in the example) would certainly be an update-proof name.