<p>Configuration Options</p>

By Nabeel

• February 21, 2010

The core/app.config.php file contains many options, to customize your system. To make these changes, copy the line from your app.config.php file, to the core/local.config.php file. The local file is not touched during any updates, except to add new options.

How to apply settings

The appropriate line is in the app.config.php file - it will look like:

Config::Set('SETTING_NAME', 'SETTING_VALUE');

Just copy the line into your local.config file. The app.config if first loaded, and then the local.config is loaded after it, so any changes made in the local.config file are used since it's loaded last.

All of the settings available are not listed here - look through the app.config.php file - they are there, along with the descriptions.

Available Settings

PAGE_ENCODING

This is the page encoding to use for the site. Internationalized sites may use UTF-8.

PAGE_EXT

This is the extension of pages. Leave as .htm, unless you know what you're doing.

PILOTID_OFFSET

The system starts with an ID of 1. You can start it from 1001, or 5001. This won't change the ID in the database, just the appearance.

PILOTID_LENGTH

This is the length of the ID. Default is 4, so a number will show as 0001. The length includes the ID number.

LOAD_FACTOR

Config::Set('LOAD_FACTOR', '72');

This setting determines the % of MAXLOAD which are on a flight. The system will generate a passenger/cargo load based off of this number. The industry load factor at this time is 72% (according to ATA). Can be adjusted, not more than 90%. phpVMS will decide between +/- 10% of LOAD_FACTOR

UNITS

Config::Set('UNITS', 'nm'); 

Enter nm (nautical miles), mi (miles), or km (kilometers). This will affect distance calculations

CARGO_UNITS

Config::Set('CARGO_UNITS', 'lbs');

This is your units for cargo flights - lbs/kg/newtons. This is just the text which is displayed

MONEY_UNIT

Config::Set('MONEY_UNIT', ' ); 

This is the unit of money. For non-dollars, use : Euro (€), enter ”€” Yen (Â¥), enter ”¥â€ Pounds (£), enter ”£â€ For example:

Config::Set('MONEY_UNIT', '€'); // For Euro

DEFAULT_MAX_CARGO_LOAD

This is if your aircraft do not have a default set. There is a penalty if these values end up being used

Config::Set('DEFAULT_MAX_CARGO_LOAD', 10000);

DEFAULT_MAX_PAX_LOAD

This is if your aircraft don't have a passenger load set. There is a penalty if this is used.

Config::Set('DEFAULT_MAX_PAX_LOAD', 250);

PILOT_AUTO_RETIRE

Whether to automatically retire a pilot. True/false value. The next setting is for how many days. Inactivity = no PIREP filings.

Config::Set('PILOT_AUTO_RETIRE', true);

PILOT_INACTIVE_TIME

After how much time, in days, to mark a pilot retired.

Config::Set('PILOT_INACTIVE_TIME', 90);

PILOT_AUTO_CONFIRM

Whether to automatically confirm pilots, or require admin approval. Default is fault

Config::Set('PILOT_AUTO_CONFIRM', false);

PIREP_CUSTOM_FIELD_EDIT

After submitting a PIREP, a pilot can edit their PIREP, but only the custom fields. This is the time, in hours, they're allowed to do that.

Config::Set('PIREP_CUSTOM_FIELD_EDIT', '48');

SCHEDULES_ORDER_BY

What to order schedules by. Use s.[column_name] [ASC/DESC], with the column name being from the schedules table

Config::Set('SCHEDULES_ORDER_BY', 's.flightnum ASC');

PIREPS_ORDER_BY

For PIREPS_ORDER_BY use p.[column_name] [ASC/DESC]

Config::Set('PIREPS_ORDER_BY', 'p.submitdate DESC');

DISABLE_SCHED_ON_BID

If someone places a bid on a route, if that route is shown or not

Config::Set('DISABLE_SCHED_ON_BID', true);

DISABLE_BIDS_ON_BID

If the above is false, this won't allow bids on a flight which has already been bid on

Config::Set('DISABLE_BIDS_ON_BID', false);

TRANSFER_HOURS_IN_RANKS

If you want to count transfer hours in rank calculations

Config::Set('TRANSFER_HOURS_IN_RANKS', false);

USERS_ONLINE_TIME

The StatsData::UserOnline() function - how many minutes to check

Config::Set('USERS_ONLINE_TIME', 20);

WeightUnit

0=Kg 1=lbs

Config::Set('WeightUnit', '1'); 

DistanceUnit

0=KM 1= Miles 2=NMiles

Config::Set('DistanceUnit', '2'); 

SpeedUnit

0=Km/H 1=Kts

Config::Set('SpeedUnit', '1');

AltUnit

0=Meter 1=Feet

Config::Set('AltUnit', '1');

LiquidUnit

0=liter 1=gal 2=kg 3=lbs

Config::Set('LiquidUnit', '3'); 

WelcomeMessage

For FSPassengers

Config::Set('WelcomeMessage', 'phpVMS/FSPAX ACARS');

FSFK FTP Settings

Your FTP Server, and path to the lib/images folder (from where the FTP connects from), IE

ftp://phpvms.net/phpvms/lib/fsfk or ftp://phpvms.net/pub...phpvms/lib/fsfk

You want the path from when you connect to the FTP down to where the /lib/fsfk folder is

Config::Set('FSFK_FTP_SERVER', '');
Config::Set('FSFK_FTP_PORT', '21');
Config::Set('FSFK_FTP_USER', '');
Config::Set('FSFK_FTP_PASS', '');
Config::Set('FSFK_FTP_PASSIVE_MODE', 'TRUE');
Config::Set('FSFK_IMAGE_PATH', '/lib/fsfk'); // web path from SITE_ROOT

Signature Settings

Settings for the signatures which are generated for pilots.

Config::Set('SIGNATURE_TEXT_COLOR', '#000');
Config::Set('SIGNATURE_SHOW_EARNINGS', true);
Config::Set('SIGNATURE_SHOW_RANK_IMAGE', true);
Config::Set('SIGNATURE_SHOW_COPYRIGHT', true);

Email Settings

Config::Set('EMAIL_FROM_NAME', '');
Config::Set('EMAIL_FROM_ADDRESS', ''); Config::Set('EMAIL_USE_SMTP', false);
# Add multiple SMTP servers by separating them with ;
Config::Set('EMAIL_SMTP_SERVERS', '');
Config::Set('EMAIL_SMTP_PORT', '25');
Config::Set('EMAIL_SMTP_USE_AUTH', false);
Config::Set('EMAIL_SMTP_USER', '');
Config::Set('EMAIL_SMTP_PASS', '');