Skip to content

Commit

Permalink
Update docs structure.
Browse files Browse the repository at this point in the history
Signed-off-by: crynobone <crynobone@gmail.com>
  • Loading branch information
crynobone committed Dec 7, 2013
1 parent f98811e commit d056611
Show file tree
Hide file tree
Showing 3 changed files with 52 additions and 52 deletions.
55 changes: 28 additions & 27 deletions docs/changes.md
@@ -1,9 +1,10 @@
Foundation Change Log
==============
---
title: Foundation Change Log
---

## Version 2.0
## Version 2.0 {#v2-0}

### v2.0.23
### v2.0.23 {#v2-0-23}

* Automatically login the user after resetting the password.
* Refactor call to `Orchestra\Extension\RouteGenerator` based on changes to orchestra/extension component.
Expand All @@ -13,13 +14,13 @@ Foundation Change Log
* Add `orchestra/debug`.
* Update Twitter Bootstrap v3.0.2.

### v2.0.22
### v2.0.22 {#v2-0-22}

* Fixed `Javie.Events` usage on triggering switcher event.
* Manage Twitter Bootstrap using Composer.
* Implement [PSR-2](https://github.com/php-fig/fig-standards/blob/master/accepted/PSR-2-coding-style-guide.md) coding standard.

### v2.0.21
### v2.0.21 {#v2-0-21}

* Add `orchestra/foundation::layout.extra` layout view, to be used for registration, login and forgot password interface.
* Cast possible integer to string on return `ID` from `User` model.
Expand All @@ -29,7 +30,7 @@ Foundation Change Log
* Move `Orchestra\Model` to it's own repository, this would allow it to be used with orchestra/auth on project without Orchestra Platform.
* Multiple namespace refactors.

### v2.0.20
### v2.0.20 {#v2-0-20}

* Allow Orchestra Platform route to make use of latest `Orchestra\Extension\RequestGenerator` feature allowing subdomain handling.
* Fixed `Orchestra\Mail` using queues doesn't respect configuration from `Orchestra\Memory`.
Expand All @@ -42,7 +43,7 @@ Foundation Change Log
- jQuery UI v1.10.3
- Select2 v3.4.3

### v2.0.19
### v2.0.19 {#v2-0-19}

* Re-enable reset password e-mail to be sent using configurable e-mail dispatcher (either direct send or queue).
* Allow customization redirection from logout request.
Expand All @@ -53,15 +54,15 @@ Foundation Change Log
* Add missing successful reset password message.
* Refactor presenters to use app container to allow IoC overwrite from application.

### v2.0.18
### v2.0.18 {#v2-0-18}

* Rework on `Orchestra\Foundation\Mail` to handle inconsistency using both `Mail::queue()` and `Mail::send()`, add new `Orchestra\Mail::push()` option to allow sending based on configuration.
* Both `Orchestra\Mail::send()` and `Orchestra\Mail::queue()` work as you would using `Mail` equivalent.
* Refactor `Orchestra\Foundation\Reminders\PasswordBroker` to force send email directly even if queue is enabled. This is a limitation with `Illuminate\Support\SerializeClosure` that does support use () to include Closure.
* Fixed messages when registration email is sent using queue, instead of showing failed to send.
* Improve user searching with new `Orchestra\Support\Str::searchable()` API.

### v2.0.17
### v2.0.17 {#v2-0-17}

* Add `orchestra/translation`.
* Improved asset management especially for Twitter Bootstrap.
Expand All @@ -70,27 +71,27 @@ Foundation Change Log
* Separate large view into partial especially on `extensions` and `resources` route for easier theming.
* Fixed some regression bug.

### v2.0.16
### v2.0.16 {#v2-0-16}

* Update to Twitter Bootstrap v3.0.0.
* Slightly improved Navbar Decorator.

### v2.0.15
### v2.0.15 {#v2-0-15}

* Add padding to `.navbar a-navbar.brand` CSS.
* Update Bootstrap 3.0-RC2.
* `Orchestra\Foundation\Reminders\PasswordBroker` should extends `Illuminate\Auth\Reminders\PasswordBroker`.
* Fixed CSS styling based on Bootstrap 3-RC2 changes.
* Fixed inconsistent form styling on reset password page.

### v2.0.14
### v2.0.14 {#v2-0-14}

* Update Twitter Bootstrap 3.
* Change footer to show "Powered by Orchestra Platform" instead of a copyright.
* Tweak installation message on Auth usage.
* Convert prefered function to use `Orchestra\Auth\Acl\Fluent::attach()` instead of `Orchestra\Auth\Acl\Fluent::fill()`.

### v2.0.13
### v2.0.13 {#v2-0-13}

* Replace deprecated call to `Orchestra\Extension::isActive()` and instead use `Orchestra\Extension::activated()`.
* Replace call to `handles('orchestra/foundation::*')` to `handles('orchestra::*')`.
Expand All @@ -101,80 +102,80 @@ Foundation Change Log
* Add testcase for `Orchestra\Foundation\Routing\CredentialController`.
* Fixed CSS issue on create/update User using Select2.

### v2.0.12
### v2.0.12 {#v2-0-12}

* Update to Twitter Bootstrap 3.0.0-RC1.
* Clean-up CSS, JavaScript as well as HTML to match Bootstrap 3.

### v2.0.11
### v2.0.11 {#v2-0-11}

* Fixed typo to `Orchestra\Extension::isActive()`.
* Add safe mode notification when running from safe mode.
* Docblock improvement.

### v2.0.10
### v2.0.10 {#v2-0-10}

* Update Bootstrap 3.
* Remove requirement to use `Illuminate\Support\Fluent` on `Orchestra\Foundation\Services\Validation\UserAccount`.
* Add client-side JavaScript event on each page load.
* Code improvements.
* Fixed `mkdir(): Permission denied` while uploading extension asset using FTP Publisher.

### v2.0.9
### v2.0.9 {#v2-0-9}

* Rename `Orchestra\Foundation\Site::localtime()` to `Orchestra\Foundation\Site::toLocalTime()`.
* Fixed date is not appended when attaching role to a user, add `withTimestamps()` options to both `Orchestra\Model\User` and `Orchestra\Model\Role`.
* Add `Orchestra\Foundation\Site::fromLocalTime()` to convert time from local to what set in `"app.timezone"` config.
* Add `Orchestra\Foundation\Application::locate()` to return relative path to packages/app.

### v2.0.8
### v2.0.8 {#v2-0-8}

* Optimize use of `orchestra/foundation::layout.widgets.header` view.
* Create table and form view for `Orchestra\Html\Table` and `Orchestra\Html\Form`.
* Update Bootstrap 3 files.

### v2.0.7
### v2.0.7 {#v2-0-7}

* Allow `Orchestra\Foundation\Services\UserMetaRepository` to look for data from eloquent before resolving to default.
* Fixed a bug where no roles is assigned to registered user.
* Improved the base grid system to be more readable.
* Multiple bugfixes to the UX and CSS.

### v2.0.6
### v2.0.6 {#v2-0-6}

* Tweak Resources menu to be not shown when all resources are hidden.
* Fixed unable to use Publisher FTP since `Illuminate\Filesystem\Filesystem::makeDirectory()` throws PHP error when creating directory failed.

### v2.0.5
### v2.0.5 {#v2-0-5}

* Move `Orchestra\Services` to `Orchestra\Foundation\Services`.
* Move `Orchestra\Routing` to `Orchestra\Foundation\Routing`.
* All classes are mapped using PSR-0.
* Improved default theme.
* Fixed CSS styling on FTP publisher page.

### v2.0.4
### v2.0.4 {#v2-0-4}

* Allow guest user to access resources if ACL permit.
* Fixed CSS on User search form.

### v2.0.3
### v2.0.3 {#v2-0-3}

* Add `@placeholder("orchestra.resources: {name}")`.
* Add data-id attributes to edit and delete link on users page.

### v2.0.2
### v2.0.2 {#v2-0-2}

* Fixed unable to use `"orchestra.saving: extension.{name}"` event.
* Implement `"orchestra.validate: extension.{name}"` and `Orchestra\Services\Validation\Extension`.
* Fixed regression bug with new implementation on `Orchestra\Support\Validator`.

### v2.0.1
### v2.0.1 {#v2-0-1}

* Tweak Users search form CSS to match Bootstrap 3.
* Fixed a bug where Extension's handles configuration is not accessible.

### v2.0.0
### v2.0.0 {#v2-0-0}

* Migrate `Orchestra\Foundation` from Orchestra Platform 1.2.
* Convert `Orchestra\Core` to `Orchestra\App`.
Expand Down
39 changes: 19 additions & 20 deletions docs/mail.md
@@ -1,37 +1,36 @@
Orchestra Mail Class
==============
---
title: Orchestra Mail Class
---

* [Force Direct Sending](#force-direct-sending)
* [Force Sending via Queue](#force-send-queue)
* [Sending via Configuration](#sending-via-config)

`Orchestra\Mail` offer a slight improvement to `Illuminate\Mail\Mailer` where administrator can define the e-mail configuration from Settings page as well as preference to use `send` or `queue`.

## Force Direct Sending
## Force Direct Sending {#force-direct-sending}

`Orchestra\Mail::send()` deliver what you would expect from `Mail::send()` using the E-mail configuration setup in the Settings Page.

```php
Orchestra\Mail::send('email.update', $data, function ($m) use ($user) {
$m->to($user->email);
});
```
Orchestra\Mail::send('email.update', $data, function ($m) use ($user) {
$m->to($user->email);
});

## Force Sending via Queue
## Force Sending via Queue {#force-send-queue}

`Orchestra\Mail::queue()` deliver what you would expect from `Mail::queue()` using the E-mail configuration setup in the Settings Page.

```php
Orchestra\Mail::queue('email.update', $data, function ($m) use ($user) {
$m->to($user->email);
});
```
Orchestra\Mail::queue('email.update', $data, function ($m) use ($user) {
$m->to($user->email);
});

## Sending via Configuration
## Sending via Configuration {#sending-via-config}

`Orchestra\Mail::push()` would first check whether the administrator has choosen to send email directly or delayed it via queue.

```php
Orchestra\Mail::push('email.update', $data, function ($m) use ($user) {
$m->to($user->email);
});
```
Orchestra\Mail::push('email.update', $data, function ($m) use ($user) {
$m->to($user->email);
});

> The API is identical to `Illuminate\Mail\Mailer` with the exception that administrator can configure to choose "Mail via Queue" in the Settings Page.
10 changes: 5 additions & 5 deletions docs/readme.md
@@ -1,13 +1,13 @@
Foundation Component
==============
---
title: Foundation Component
---

`Orchestra\Foundation` is the core of Orchestra Platform. The installation of this component would require additional boilerplate app skeleton which is available from [orchestra/platform](https://github.com/orchestral/platform).

## Installation

Orchestra Platform is easily install using [Composer](http://getcomposer.org).

```bash
composer create-project orchestra/platform website --prefer-dist
```

composer create-project orchestra/platform website --prefer-dist

0 comments on commit d056611

Please sign in to comment.