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 your settings are normally read from the conf/site.php. But when your site is currently in production, you might like to change some settings to test some features, while not showing this currently to your visitor.

For this purpose, you can add “?dev=1” to any url of you website, to use an alternate configuration file. In this case, the configuration file used will be conf/site_dev.php instead of the regular conf/site.php.

Basics

All configurations parameters are stored in the $pvw_conf array, like that:

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

Defaults Settings

Most settings values (except “id”, “site_name” and “baseline”) are automatically filled with a default value if there are not set or empty. Example: if you set 'navbar_width' to '2', the '2' value will be used. If you ommit it, il will default to the value of '1'.

Check current Values and Descriptions from Private

You will find the list of all possible parameters, and their current values (set by you, or set by the defaults) from your Private area, in the Web menu, and the Hosting Configuration tab at http://private.plugivery.com/web/#tab_web_pvw . Each parameter's effect is explained in this page.

Emails

are stored in : $pvw_conf['emails']

When a visitor of your site use the contact form, depending on the departement he choose (support or general), his message will be sent to the email addresses set there, Ie:

$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 (mostly externals) that provide some extra features for your site. They are all off by default. Here is the list of all widgets :

  • share : add a well known Share widget fixed on the left or right side of the page.
  • share2 : same as the share widget , but located inside the page, near the title
  • share_news : another share widget added near each News title, in the News views, allowing to share each news individually, instead of the whole News List page.
  • follow : add a Follow widget fixed on top of the page.
  • fb_like : a Facebook LikeBox, that can be inserted in Boxes.

Each widget can be activated by setting its 'on' parameter to 1, and each parameter default value can be overriden by your own value.

Ie to active the share widget, with 10 icons (instead of 5, the default value), 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.