| {maketoc}
|
| +The central architectural concept in bitweaver is known as a "Package". This is just a directory with all the files relating to a particular feature. We call it a Package because it is larger than a plugin. In fact, and package can have it's own plugins, such as the LibertyPackage. The term *modules* was already taken for the display blocks that appear on the borders of the page. |
| + |
| !Package Architecture
|
| ^The design is simple: Put all files related to each feature into their own directory^
|
| -__A Tiki Package is simply a directory in the Tiki root directory.__ An optional requirement is a folder inside your package directory called "tiki". Inside it will be tiki-centric initialization files such as a file called "tiki_setup_inc.php" that will get included by the KernelPackage during initialization. Other optional files will include a "local_inc{{.$tikidomain}.php" for settings particular to a user's install. A TikiPackage can be a set of highly integrated features such as the WikiPackage or BlogPackage or it could be an external app, like phpBB, adopted to use the Tiki framework with minimal modifications to keep it VirginSource.
|
| +__A bitweaver package is simply a directory in the bitweaver root directory.__ An optional requirement is a bitweaver-centric initialization file called "bit_setup_inc.php" that will get included by the KernelPackage during initialization. A bitweaver package can be a set of highly-integrated features such as the WikiPackage or BlogPackage or it could be an external app, like phpBB, adopted to use the bitweaver framework with minimal modifications to keep it VirginSource. |
|
|
| -The KernelPackage will automatically create __two standard 'define's__ for every package: <NAME>_PKG_PATH and <NAME>_PKG_URL, where <NAME> is simply your package name (aka, the name of the directory in the Tiki root.) For example, IMAGEGALS_PKG_PATH and IMAGEGALS_PKG_URL will be created for the "imagegals" package.
|
| +The KernelPackage will automatically create __two standard 'define's__ for every package: <NAME>_PKG_PATH and <NAME>_PKG_URL, where <NAME> is simply your package name (aka, the name of the directory in the bitweaver root.) For example, FISHEYE_PKG_PATH and FISHEYE_PKG_URL will be created for the FisheyePackage. You can easily rename the package directory and you don't have to touch a line of code or setting anywhere. Yes, just move "fisheye" to "[/photos|photos]" or "phpbb" to "[/forums|forums]" and reload your browser. |
|
|
| -The solution is low tech and dirt simple. TikiPro does not __insist__ on a large API infrastructure when some TikiPackages might only need to execute a few lines of code. Other TikiPackages might need to access a more complex TikiProAPI. So let developer's decide for themselves how simple or complex to make their own Package. This should also allow ports to stay as virgin as possible, and stay much more up to date with their own code base.
|
| +The solution is low tech and dirt simple. bitweaver does not __insist__ on a large API infrastructure when some packages might only need to execute a few lines of code. Other packages might need to access a more complex bitweaverAPI. So bitweaver lets developers decide for themselves how simple or complex to make their own package. This should also allow ports to stay as virgin as possible, and stay much more up to date with their own code base. |
| + |
| +Using packages, features can be added and removed at will, without breaking things. By segregating and creating packages for all features, the doors are opened to many application integrations. It also gives new packages the flexibility and robustness to grow at their own rate. |
|
|
| Be sure to read ((TemplatesPackage)).
|
|
|
| Here is an example of the directory structure:
|
| -
|
| +{code in="bash"} |
| root/
|
| + articles/
|
| + blogs/
|
| + admin/
|
| - admin_blogs_inc.php
|
| + - schema_inc.php |
| + - upgrade_inc.php |
| + templates/
|
| - admin_blogs.tpl
|
| + modules/
|
| - mod_last_blog_posts.tpl
|
| - mod_last_blog_posts.php
|
| + - bit_setup_inc.php |
| - blog_lib.php
|
| - blog_rss.php
|
| - edit.php
|