Skip to content

Commit

Permalink
Merge branch 'release/2.0.0'
Browse files Browse the repository at this point in the history
  • Loading branch information
ercanozkaya committed Sep 18, 2014
2 parents 1cb153e + be46a1f commit 49ab1e1
Show file tree
Hide file tree
Showing 1,021 changed files with 120,891 additions and 41,472 deletions.
677 changes: 677 additions & 0 deletions LICENSE.txt

Large diffs are not rendered by default.

108 changes: 108 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,108 @@
Nooku Framework
===============

What is Nooku Framework?
-------------------------

Nooku Framework is a open-source **extension framework** for **[Joomla](http://www.joomla.org)**. Developed and maintained by
[Timble](http://timble.net) with the help of passionate developers from all over the world.

Nooku Framework can be installed in Joomla as a plugin and lets you focus on the "business" logic of your extension. By
doing most of the repetitive work for you [boilerplate code][boilerplate] is eliminated which greatly reduces the time
to develop Joomla extensions.

The design pattern based architecture makes your extension more flexible: your extension becomes more **re-usable**,
**replaceable** and more easily **extensible**. Additionally Nooku Framework provides you with excellent **out-of-the-box
security** features.

Nooku Framework uses a [component based architecture](http://en.wikipedia.org/wiki/Component-based_software_engineering)
and includes everything needed to create Joomla extensions according to the [Hierarchical Model-View-Contoller][HMVC]
**(HMVC)** pattern.

Why Nooku Framework?
--------------------

Nooku Framework is built to help developers create **custom** Joomla extensions and tries to solve following problems:

* Abstract differences between Joomla versions 2.x and 3.x.
* Provide a solid modern and lean architecture for building extensions.
* Allow extensions to be more flexible and extended easily.

Who is Nooku Framework for ?
----------------------------

Nooku Framework is for developers creating custom Joomla extensions. The framework can only be installed using Composer
and cannot be installed using the Joomla installer. If you are a developer who wishes to distribute the framework as part
of an installable package please [contact us](http://www.timble.net/contact/) first.

Production Ready
----------------

The framework uses a conservative development approach focused on the lowest common denominator, at time of writing this
is Joomla 2.5 and PHP 5.2. The framework is fully forwards compatible with Joomla 3.x and PHP 5.x.

The framework follows the [semantic versioning standard](http://semver.org/). Rest assured : it's designed for stability
and compatibility. We promise that all minor versions will be 100% backwards compatible. Only in major versions backwards
compatibility is not guaranteed.

*Note* : If you are looking for the the greatest and latest stuff we are working on check out [Nooku Platform][nooku-platform],
a fork from Joomla that is being completely rebuild using Nooku Framework.

Requirements
------------

* Joomla 2.5 and 3.x
* PHP 5.2 or newer
* MySQL 5.x

Installation
------------

* Create a `composer.json` file in the root directory of your Joomla installation and require the `nooku/nooku-framework`
package:

```json
{
"require": {
"nooku/nooku-framework": "dev-develop"
},
"minimum-stability": "dev"
}
```

* Install by executing `composer install`.

Contributing
------------

We appreciate any contribution to Nooku Framework, whether it is related to bugs, grammar, or simply a suggestion or
improvement. We ask that any contribution follows a few simple guidelines in order to be properly received.

We follow the [GitFlow][gitflow-model] branching model, from development to release. If you are not familiar with it,
there are several guides and tutorials to make you understand what it is about. If you haven't, you will probably want
to get started by installing this very good collection of [git extensions][gitflow-extensions].

What you should know before submitting a pull request :

- If you are submitting a bug-fix, or an enhancement that is not a breaking change, submit your pull request to the
branch corresponding to the latest stable release of the framework, such as the 2.0 `release` branch
- If you are submitting a breaking change or an entirely new feature, submit your pull request against the `develop`
branch.
- It's very well appreciated, and highly suggested, to start a new feature branch whenever you want to make changes or
add functionalities. It will make it much easier for us to just checkout your feature branch and test it, before merging
it into `develop`
- We will not consider pull requests made to the `master`.

License
-------

Nooku Framework is open-source software licensed under the [GPLv3 license](LICENSE.txt).

[HMVC]: http://en.wikipedia.org/wiki/Hierarchical_model%E2%80%93view%E2%80%93controller
[boilerplate]: http://en.wikipedia.org/wiki/Boilerplate_code

[nooku-platform]: https://github.com/nooku/nooku-platform
[nooku-framework]: https://github.com/nooku/nooku-framework

[gitflow-model]: http://nvie.com/posts/a-successful-git-branching-model/
[gitflow-extensions]: https://github.com/nvie/gitflow
26 changes: 26 additions & 0 deletions apigen.neon
Original file line number Diff line number Diff line change
@@ -0,0 +1,26 @@
# Use like: php -d memory_limit=512M /usr/bin/apigen -d /output/dir --config apigen.neon

# Source file or directory to parse
source: code

# List of allowed file extensions
extensions: [php]
# Mask to exclude file or directory from processing
exclude: [*/administrator/manifests/*,*/plugins/system/koowa/*,*/libraries/koowa/libraries/legacy.php,*/administrator/manifests/files/files_koowa/script.php]

# Generate documentation for elements marked as internal and display internal documentation parts
internal: No
# Generate documentation for PHP internal classes
php: No
# Generate tree view of classes, interfaces and exceptions
tree: Yes
# Generate documentation for deprecated classes, methods, properties and constants
deprecated: Yes
# Generate highlighted source code files
sourceCode: Yes
# Add a link to download documentation as a ZIP archive
download: Yes

googleAnalytics: UA-214238-5

title: "Nooku Framework"
Loading

0 comments on commit 49ab1e1

Please sign in to comment.