Actions

Difference between revisions of "BasicPHPFileTemplates"

From Mahara Wiki

(Created page with "These are the templates for all new PHP files. There is a different template depending on whether you file is able to be publicly hittable or not. The templates are available in …")
 
Line 4: Line 4:
  
 
<div id="section_1"
 
<div id="section_1"
= Template for files you expect to be hit by visitors =
+
===Template for files you expect to be hit by visitors=
  
 
  .
 
  .
Line 16: Line 16:
 
   // Your code here  
 
   // Your code here  
 
  </div><div id="section_2"
 
  </div><div id="section_2"
= Template for files you do NOT want to be hit by visitors =
+
===Template for files you do NOT want to be hit by visitors=
  
 
  .
 
  .

Revision as of 16:07, 11 May 2011

These are the templates for all new PHP files. There is a different template depending on whether you file is able to be publicly hittable or not. The templates are available in /examples in version control, and should be considered the most up to date versions of these files.

This project uses PHPDoc for API documentation. This project is also licensed under the GPL, which causes some header bloat (it is a requirement of licensing your program under the GPL, see [http://www.gnu.org/copyleft/gpl.html File:Http.pnghttp://www.gnu.org/copyleft/gpl.html).

<div id="section_1"

==Template for files you expect to be hit by visitors

.
*  @package  mahara
* @subpackage core
* @author   Firstname Lastname
* @license  http://www.gnu.org/copyleft/gpl.html GNU GPL
* @copyright  (C) 2010 Firstname Lastname
*  */
 define('INTERNAL', 1)  require('init.php'
 // Your code here 

<div id="section_2"

==Template for files you do NOT want to be hit by visitors

.
*  @package  mahara
* @subpackage core or plugintype/pluginname
* @author   Firstname Lastname
* @license  http://www.gnu.org/copyleft/gpl.html GNU GPL
* @copyright  (C) 2010 Firstname Lastname
*  */
 defined('INTERNAL') || die();
 require('init.php');

 // Your code here :)

Notes:

  • Omit the closing php tag "?>"
  • Catalyst employees should assign copyright to "Catalyst IT Ltd File:Http.pnghttp://catalyst.net.nz", if they are working on the project in company time.