Comparing versions
Version 1Current version

The following files make up a bitweaver package. Your packages is free to do and act however it pleases. However, the following files are standardized and the core packages will look for these files in your packages. Only one is truly required.
Anatomy of a bitweaver Package
File Description Col 3
bit_setup_inc.php This is the only file required for a package. It registers information about the package during initial setup.
admin/schema_inc.php If your package has any database information, the information is defined in this file. It will be scanned during install, and a few adminstration pages
modules/ This directory contains the interfaces blocks that can be arranged in various layouts

 
The following files make up a bitweaver package. Your packages is free to do and act however it pleases. However, the following files are standardized and the core packages may look for these files in your packages.
Anatomy of a bitweaver Package
File Description
pkg/bit_setup_inc.phpThis is the only file required for a package. It registers information about the package during initial setup.
pkg/admin/schema_inc.php
pkg/admin/bit_schema_inc.php
If your package has any database information, the information is defined in this file. It will be scanned during install, and a few administration pages
pkg/admin/admin_pkg_inc.php
pkg/admin/bit_admin_inc.php
Administration page for the package, picked up by kernel/admin/index.php?page=pkg.
pkg/admin/upgrades/This directory contains files named with the form version.php that describe package versions and any code needed to upgrade data and tables when that version upgrade occurs.
pkg/modules/This directory contains the interfaces blocks that can be arranged in various layouts
pkg/templates/This directory contains the Smarty templates for the package pages
pkg/templates/admin_pkg.tpl
pkg/templates/bit_admin.tpl
Administration template for the package, picked up by kernel/admin/index.php?page=pkg.
pkg/templates/menu_pkg_admin.tpl
pkg/templates/bit_admin_menu.tpl
template for the package administration menu.
pkg/templates/menu_pkg.tpl
pkg/templates/menu.tpl
template for the package menu. Usually specified in pkg/bit_setup_inc.php.


The filenames specified in grey are my thoughts are what the file names could be migrated to with the aim of improving consistency and ease of understanding. The ideas being; that there is no point in package name repetition/redundancy in the file names and it is already discouraged in the CodingGuidelines, and that introducing a prefix of 'bit_' to files that are loaded just because of their names and location in a package would help indicate them as such files.
Page History
Date/CommentUserIPVersion
06 May 2009 (19:07 UTC)
Daniel Sutcliffe71.161.102.63
Current • Source
Daniel Sutcliffe71.161.102.62
View • Compare • Difference • Source
spiderr66.194.217.2211
View • Compare • Difference • Source