phpVMS Virtual Airline Administration Software
Copyright © 2008 Nabeel Shahzad
For more information, visit www.phpvms.net
Forums: http://www.phpvms.net/forum
Documentation: http://www.phpvms.net/docs
Tutorials: http://www.phpvms.net/tutorials

phpVMS is licensed under the:
Creative Commons Attribution Non-commercial Share Alike (by-nc-sa)
View license.txt in the root, or visit:
http://creativecommons.org/licenses/by-nc-sa/3.0/

Last Update: Oct 23, 2009

# Build v2.1.935 (Version 2.1.v2.1.935)

- Navigation data included for routes, more accurate maps for schedules, ACARS and PIREPS
- Financial backend overhauled, all data is in real-time, and more accurate
- Expenses are saved, so your expenses will stick and stay different, month-to-month
- Aircraft can now be tied to a minimum rank to fly them
- All charts/graphs replaced with new OFC (Open Flash Charts)
- Google Maps replaced with v3 API (no more key needed! :)
- Added reCaptcha support into the registration.
- New format for skinning - whole page layout
- Ability to change a pilot's ID
- Send mass-email to specific groups
- Maintenance cron-script, for faster/more efficient background processing
- Added 'profile badge' page with links to your signature in various formats
- And numerous bug fixes

Templates Changed:

- core_htmlhead.tpl - Javascript all cleaned up, path to Google Maps API changed for v3
- acarsmap.tpl - Completely changed with map customizations (I would just start from scratch)
- route_map.tpl - Rewritten to accomodate v3 API (I would just start from scratch)
- profile_myroutesmap.tpl - Removed, replaced with flown_routes_map.tpl, used for RouteMap
- pirep_new.tpl - Added field for route, and aircraft restriction for rank
- schedule_results.tpl - Aircraft restriction for rank
- registration_mainform.tpl - Replaced old captcha with reCaptcha
- registration_customfields.tpl - Bug fixed with textarea field type
- finance_summarysheet.tpl - Updated for new finances
- finance_header.tpl - Updated for new finances
- finances_balancesheet.tpl - Updates for new finances
- contact_form.tpl - Implemented reCaptcha

# Build 854 (Version 2.0.854)

- New: vaCentral support - the virtual airline community
- NEW: FS Flight Keeper PIREP, ACARS support
- NEW: XAcars position and PIREP support
- NEW: Group based permissions access to admin panel
- phpVMS API server has airport information (as an alternative to geonames, use whichever works for you)
- Admin can change rank manually (usefull for military)
- Bids screen in admin panel
- Maintenance mode option for site
- Pilot auto-retire option (X days after last PIREP or last login with no PIREPs)
- Overhauled backend (much faster!) and code cleanup (see the template changes)
- Overhauled addon system, simplifying development
- ACARS map icons now point in the heading of the airplane (calculated for FSACARS)
- "Remember Me" login option added, session tracking (see the next item)
- Show the current online users and guests in stats
- Schedule export for easy editing, then you can reimport it for updates
- Additional signature customization options
- New default skin with some examples - I got tired of looking at the old one
- Partial language/translation files for admin panel (english language included)
- Added option to disable live fuel prices
- Aircraft statistics hours bug-fix
- Pilot salary bug fixed
- Better handling of adding bids on the client side
- ...numerous other bug fixes and improvements!

Important - read the upgrade guide!

Templates Changed:

Every template has been touched, to use the new url() function. Instead of including SITE_URL/index.php/module/path, it is now just url('/module/path'). Specific changes are listed below:

- core_htmlhead.tpl - Path to Google Maps API changed
- profile_main.tpl - Added link to XAcars and FSKF config files, changed avatar link to use PilotData::getPilotAvatar (if there's no avatar, uses /lib/images/noavatar.png)
- frontpage_main.tpl - Added "Users Online" section, fixed the news call
- downloads_list.tpl - Link to download has changed
- login_form.tpl - Added input checkbox for "Remember Me"
- route_map.tpl - Rewritten for new Google Map code
- pireps_viewall.tpl - Added link to add comment to PIREP and edit PIREP
- registration_customfields.tpl - Added dropdown field box type for custom fields
- profile_edit.tpl - Added dropdown field box type for custom fields
- pilot_public_profile.tpl - Added chart for latest PIREPs
- schedule_details.tpl - Schedule flown frequency chart replaced

# Build 700 (Version 1.2.700)

- NEW: Pilot briefing page added, with weather maps, links to airport diagram (Unfortunately, only for US airports)
- NEW: Boarding pass available from bid page
- NEW: Added option to allow only one bid per schedule, and hide schedule
- Memory usage enhancements (cut by at least 50% overall)
- Download change category bug fixed
- Added "Approve All" in PIREPs
- Awards on all pilot pages fixed
- Time bug fixed (I know... again)
- Admin aircraft stats bug fixed (thanks Nige!)
- Page navigation bug fixed
- Page delete bug fixed

Templates Changed:

- core_navigation.tpl - Allow access roles to admin panel (link
- schedule_results.tpl - Added link to brief page
- schedule_bids.tpl - Added link to boarding pass

# Build 661 (Version 1.2.661)

- NEW: Pilot awards
- NEW: Fuel prices are pulled from server (currently works only for US airports)
- NEW: Mass-mailer functionality, to email all pilots
- NEW: Captcha on registration page (update your registration_mainform.tpl)
- NEW: Transfer hours field added to pilot profile, to prevent conflicts
- NEW: Admin can now set a pilot as 'retired', won't allow login until admin reactivates
- NEW: Days of week indicator for schedule
- Added maintenance option to reset VA hours (algorithm is now proper, I promise!)
- Flights to/from the same airport allowed (to accomodate military flights)
- Added maintenace option to reset pilot hours
- Pilot hour aggregation bug fixed
- Signature background image bug fixed (if there is no background image selected)
- Contact form errors fixed
- Schedules frequence chart fixed
- FSACARS "Flight From VA" working, with pax counts. Retrieves latest bid
- FSPax and FSACARS bug fixed when using offset for pilot ID
- FSPax exported flights now use the default aircraft from the schedule, since FSP doesn't report an aircraft
- Contact page error fixed

Templates Changed:

- registration_mainform.tpl - Captcha added
- profile_main.tpl - Changed total time to account for transfer hours, and time remaining
- pilots_list.tpl - Changed total time to account for transfer hours
- pilot_public_profile.tpl - Same as above
- schedule_results.tpl - Skip over schedules which aren't for the current day, show the days of week it's flown

# Build 610 (Version 1.2.610)

- NEW: FSPassengers Support - export your flight reports to phpVMS; downloadable config file
- NEW: Download manager - create categories and add downloads, track # of downloads (Link: index.php/downloads)
- NEW: Contact Form - Easy way for members and non-members to contact, non-members see a simple Captcha (Link: index.php/contact)
  - Any extra fields added into form in the contact template will also be emailed to the webmaster email (so you can add another <input type="text" name="custom" /> and that will be included in the email
- NEW: Schedule Data: Added four fields to schedules and import: Type, Maxload, Price and FlightType- for financials later on.
  - Type - This is whether it's a passenger or cargo flight (value of P or C, P is default)
  - Price - This is the price per unit - if it's a passenger flight, it's the average ticket price; if it's a cargo flight, then it's the price per CARGO_UNIT (ie, per lb/kg)
  - Flight Type - Passenger (P), Cargo (C), Charter (H). Charter flights operate at 100% LOAD_FACTOR,
- NEW: Monthly Expenses area added under financials - itemize your monthly, or per-flight expenses to be factored into calculations
- NEW: Aircraft Details added, including maximum number of passengers and cargo, for passenger/charter and cargo flights
- NEW: Per Flight Expenses - add expenses that are "charged" per-flight (for example, de-icing, catering)
- NEW: Fuel Used/Fuel Prices are taken into account for finances, with per-airport fuel-prices for accurate pricing
- NEW: Financial Data - View your VA's financial performance, with per-Month/Year views, with detailed reports and charts
  - Based on PIREP and expenses data
  - Fuel costs are taken into account
  - Graphs, charts of average prices, expenses, fuel prices
  - Monthly expense breakdown
  - Yearly summary breakdown
- NEW: Signature background images can be selected by a pilot (just place your background png files (any filename) in /lib/signature/backgrounds)
- Flight leg removed (if you're using legs now, it's just ignored)
- Enabled/disable aircraft (retirement)
- Revamped and reorganized Admin Panel
- Backend optimizations, Javascript trimmed down, libraries removed.
- New Javascript condensor to reduce HTTP requests (marked speed improvement)
- Update to jQuery 1.3.0/1.3.1 - includes many optimizations and JS bugfixes
- Admin Dashboard now shows news from the main site
- Distance for flights can be automatically calculated
- PIREPs ask for fuel used, required field. Automatically taken from FSACARS/FSPAX
- Various FSACARS bug fixes and improvments
- FSACARS retrieves flight information from most recent bid
- Login using email or pilot ID (eg: VMA001 or bob@bobloblaw.com)
- You can now delete PIREPS (including ones already accepted, they will subtract from the pilot's record)
- Maintenance section to calculate distances for routes/pireps (for accurate stats)
- PIREPS determine a passenger count based on a new config setting called LOAD_FACTOR (explained below)
- Duplicate schedules on import now overwrite previous existing schedule
- Pilot (properly) notified of registration status
- Customizable "Registration Accepted" email
- Email sent to admin on registration/PIREP submission
- Search list aircraft dupes and results fixed
- Google Maps "createMarkerIcon()" error fixed
- Fixed active/inactive schedules view
- Update checking bug fixed
- Several security fixes

New Settings:

    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

    Config::Set('CARGO_UNITS', 'lbs');
    This is your units for cargo flights - lbs/kg/newtons ;)

    Config::Set('UNITS', 'nm');
    Enter nm (nautical miles), mi (miles), or km (kilometers)
    This will affect distance calculations

    Config::Set('VA_START_DATE', 'October 2008');

    	This is the month your VA started, used for stats.

    Config::Set('MONEY_UNIT', '$');
    This is the unit of money. For non-dollars, use :
    	Euro (€), enter "&#8364;"
        Yen (¥), enter "&yen;"
        Pounds (£), enter "&pound;"

    For example:
    	Config::Set('MONEY_UNIT', '&#8364;'); // For Euro

    There are also various settings for FSPAX, please make sure those are proper

Template Changes:

Added:

    core_htmlhead.tpl - Revert to the default one

    	contact_form.tpl - The contact form. Any extra fields added here will also be emailed
    downloads_list.tpl - Shows the main list of categories and downloads
    download_item.tpl - This is the "Downloading Now" page
    finance_balancesheet.tpl - BEWARE. Try NOT to edit this one

    finance_header.tpl - Same as above

    finance_summarysheet.tpl - Same as above

Changed:

    profile_main.tpl - Added link to download page, financials, and FSPassengers config link:

    <li><a href="<?php echo SITE_URL ?>/index.php/downloads">View
    	Downloads</a></li> --- <li><a href="<?php echo SITE_URL
    	?>/index.php/finances">View VA Finances</a></li>

    ---

    <li><a href="<?php echo SITE_URL?>/action.php/acars/fspaxconfig">Download
    	FSPax Config</li>

    schedule_details.tpl - Chart change

    pirep_new.tpl - Added "Fuel Used" field, and removed flight leg field

    profile_edit.tpl - Select box for signature background images

# Build 458 (Version 1.1.458)

- Added page encoding option
- Added option for changing pilot ID length
- Added option to change signature text color
- Admin can edit PIREPS
- Some admin reports added
- FSACARS bug fixes
- Admin panel styles cleaned up
- Bug fixes (alot of em!)
- Template Changes:

    core_htmlhead.tpl - added page encoding meta tag

# Build 441 (Version 1.1.441)

- Basic stats in Admin Panel
- View only active/inactive schedules
- PIREP table fixed (major bug fix)

Template Changes:

    pirep_new.tpl - the Aircraft option field value has changed
    			MAKE SURE YOU CHANGE THIS or else your PIREPS will fail

    pireps_viewall.tpl - Aircraft registration added to list

    pirep_viewreport.tpl - Aircraft added to view

# Build 437 (Version 1.1.437)

- Aircraft registration options added
- Routes can be assigned specific aircraft/registration
- Pilot avatars added, with sizing options (/lib/avatars need write permissions)
- Delete pilots (go in the Pilot Options in Admin Panel)
- Pilot country with flag images added
- Dynamic signatures generated, to use on forums, etc (/lib/signatures need write permissions)
- Bug fixes for servers with short_open_tags off
- ACARS map shows the proper map type/centers according to settings
- Admin edit of profile didn't recalculate for new rank
- Bids are removed now when PIREP is done through ACARS
- Updates to the updater, will automatically put new options in your local config
- Template Changes: (use WinMerge to see changes):

    registration_mainform.tpl
    profile_main.tpl
    profile_edit.tpl
    pilot_public_profile.tpl
    pilots_list.tpl
    pirep_new.tpl
    pirep_viewreport.tpl (reorganized)

# Build 400 (Version 1.1.400)

- FSACARS status updates and PIREPS support (thanks to Roger from www.fspaintshop.com for the icons!)
- FSACARS configuration file automatically generated, specific to pilot (update your profile_main.tpl)
- ACARS API so ACARS programs can be integrated through ACARS plugin
- XML interface for custom applications (ACARS, flight data) and other data
- Pilot pay! Pay rate adjustable to the rank (shows up in profile_main.tpl)
- Schedules results improved (schedule_results.tpl), update to this!
- Flight leg taken into account on checking schedule
- Profile editing bugs fixed
- Page deletes actually work (woo!)
- Pilot deleted if registration is rejected
- PIREP field insertion bug fixed
- Registration anomolies (required fields marked with *)
- PIREP submission fixed (missing flight leg)
- Ranking fixes (ranks can be deleted)
- Pages check for permission to view
- Added stats functions:

    StatsData::TotalFlights();
    StatsData::TotalHours();
    StatsData::PilotCount();

Example:

     <p>This VA has a total of <?php echo StatsData::TotalFlights();?> flights</p>

- New setting added: UNIT (Add it to your local.config.php)

    Config::Set('UNITS', 'mi'); // Your units: mi or km

# Build 370 (Release!)

- Bid deleted on PIREP submit
- PIREP fields properly show in admin panel
- PIREP fields can be edited
- Airlines can be enabled/disabled (not deleted)
- Airline names/ICAO can be changed
- WYSIWYG editor for News and Pages
- Default skin tweaks
- Profile stats back (to be expanded)
- PIREP submit form fixes
- Registration code tidied up
- Admin panel JS error fixed
- Pages visibility bug fixed
- Bug fixes

=====
http://www.phpvms.net