websee.nl: Knowledge Base

How to create a frontpage

What is a Frontpage?

- Frontpage is a set of files that used to serve your homepage, you may also call it as homepage theme.

- Unlike website themes, homepage is the place to show many important details of system, so Frontpage is a set contains both PHP files and static files; so can not edit it online, and only administrators can manage Frontpages of system.

- In this tutorial, we will show you the basic steps to create a Frontpage.

Structure of a Frontpage

Frontpage-Zipped-File.zip
- frontpage-settings.php (required)
- index.php (required)
- preview.jpg (optional)
- custom-file.php
- custom-folder
  - custom-file.css
  - custom-file.jpg

- First rule for zipped Frontpage file is all files & folders must be at root of zipped file, not at any sub-level.

- Second, you may have unlimited files and folder in a frontpage package, but frontpage-settings.php & index.php are required files. These only files shall be loaded whenenver any page of homepage browsed. You will process and handle all things in this file to serve visitors.

index.php

- You may consider a Frontpage like a mini PHP script, you may also use any material, any resource and any framework, such as Lavarel or Zend, to build your Frontpages. Just use like you want and build as you wish.

- But we also recommend you to use our built-in resources to build faster, our resources almost coded line by line for the system, so it gives the best performance & speed for your website.

Optional variables in frontpage-settings.php

// contains relative paths to web pages you want to append to current sitemap list
// all these URLs will be prepended by site domain, then added to sitemap list
$frontpage_sitemaps = array(
	'path-to-custom-page-1',	// http://www.site-domain.com/path-to-custom-page-1
	'path/to/custom/page-2',	// http://www.site-domain.com/path/to/custom/page-2
	'app/path/to/custom/',		// http://www.site-domain.com/app/path/to/custom/
);

// custom additional settings you want to add in frontpage management
// in example below, we have a select box to choose color for frontpage
$frontpage_additional_settings = array(
	array(
		'name'		=> __('Color'),		// name of setting
		'slug'		=> 'color',			// unique name for setting
		'help'		=> '',				// explaination for setting
		'type'		=> 'dropdown', 		// type of setting: text, dropdown, checkbox, input_media
		'values'	=> array(
				'blue' => __('Blue'),
				'red'  => __('Red'),
				'gold' => __('Gold')
			),
		'default'	=> 'blue'			// default value of setting
	)
);

Usable global variables and functions

- There are few variables and functions should use to create a frontpage.

CAUTION we use pTemplate for templating all static HTML files. But you may also use plain PHP code to retrieve these variable values by alternative functions.

[=GMM_SITE_NAME=]		// builder and website name
[=GMM_DOMAIN=]			// site domain or sub-domain, without http://www.
[=GMM_ADMIN_EMAIL=]		// email of super administrative account
[=GMM_APP_PATH=]		// path to root of website, normally it is root of domain
[=GMM_WEB_PATH=]		// path to root of website app
[=GMM_FRONTPAGE_PATH=]	// path to root of used current frontpage
[=GMM_COPYRIGHT=]		// copyright content of website

[=SYS_CUSTOM_HEADER=]	// custom HTML code in header
[=SYS_CUSTOM_FOOTER=]	// custom HTML code in footer

[=PAGE_TITLE=]			// title of current page, used for search engines
[=PAGE_DESCRIPTION=]	// short description of current page, used for search engines

- In order to access a plan property, we already defined some static variables

// only retrieve id, name, settings of plans with condition active=1
$db->_select($PSZ_TABLE_PLANS, 'id, name, settings', 'active=1');
if( NULL != ($plans=$db->get_result()) )
{
	foreach( $plans as $plan )
	{
		$plan_settings = unserialize(base64_decode($plan['settings']));
		
		// retrieve price of plan
		$price = get_plan($plan['settings'], 'price_monthly');

		// format price of plan, follow currency settings
		$price = GMM_number_format($price);

		// access plan property
		echo $plan_settings[ $CORE_OPTION_NAME ]; 				// name of plan
		echo $plan_settings[ $CORE_OPTION_HEADING ]; 			// title of plan
		echo $plan_settings[ $CORE_OPTION_DESCRIPTION ]; 		// description of plan
		echo $plan_settings[ $CORE_OPTION_MAX_SITES ]; 			// maximum sites of plan
		echo $plan_settings[ $CORE_OPTION_PRICE_MONTHLY ]; 		// monthly price of plan
		echo $plan_settings[ $CORE_OPTION_PRICE_3_MONTHS ]; 	// quarterly price of plan
		echo $plan_settings[ $CORE_OPTION_PRICE_6_MONTHS ]; 	// 6 months price of plan
		echo $plan_settings[ $CORE_OPTION_PRICE_YEARLY ]; 		// annual price of plan
		echo $plan_settings[ $CORE_OPTION_PRICE_FIRST ]; 		// first month price of plan
		echo $plan_settings[ $CORE_OPTION_PRICE_FIRST_TO_ALL ]; // apply first month price for all periods, TRUE / FALSE
		echo $plan_settings[ $CORE_OPTION_FEATURED ]; 			// featured state of plan, TRUE / FALSE
		echo $plan_settings[ $CORE_OPTION_BUY_BUTTON ]; 		// label of buy button
		echo $plan_settings[ $CORE_OPTION_BUTTON_SIZE ]; 		// size of buy button
		echo $plan_settings[ $CORE_OPTION_BUTTON_COLOR ]; 		// color of buy button
		echo $plan_settings[ $CORE_OPTION_CUSTOM_DOMAIN ]; 		// custom domain solution of plan, TRUE / FALSE
		echo $plan_settings[ $CORE_OPTION_TRAFFIC_COUNTER ]; 	// traffic counter solution of plan, TRUE / FALSE
		echo $plan_settings[ $CORE_OPTION_ONLINE_SHOP ]; 		// able to create store with plan, TRUE / FALSE
		echo $plan_settings[ $CORE_OPTION_SUPPORT_LIVE_CHAT ]; 	// to be supported via chat, TRUE / FALSE
		echo $plan_settings[ $CORE_OPTION_SUPPORT_EMAIL ]; 		// to be supported via email, TRUE / FALSE
		echo $plan_settings[ $CORE_OPTION_NO_ADS ]; 			// this plan has ads, TRUE / FALSE
		echo $plan_settings[ $CORE_OPTION_MAX_STORE ]; 			// maximum stores of plan
		echo $plan_settings[ $CORE_OPTION_MAX_PRODUCT ]; 		// maximum products of plan
		echo $plan_settings[ $CORE_OPTION_MAX_CATEGORY ]; 		// maximum categories of plan
		echo $plan_settings[ $CORE_OPTION_MAX_TAG ]; 			// maximum tags of plan
	}
}

don't hesitate to contact us if your thing is outside of this section
by using contact button above or send directly to gomymobi@gmail.com with subject: [contactgmm]
if could not receive our reply within 24 hours, please resend ticket again