leonardfischer / faktura

This small faktura web-application is built with Kohana in the backend and bootstrap and mootools in the frontend

ATTENTION

This project is outdated and archived, it does not work with current PHP versions. It won't receive any updates.

---

Faktura

This small faktura web-application is built with Kohana in the backend and bootstrap and mootools in the frontend.

Requirements

• Enable the PHP short tags in your php.ini (short_open_tag=On)

Installation

With version 1.1 the Faktura application will bring its own "install wizard". Here you can input your configuration (database, admin user, ...) and let the script do the rest. Currently it is not (yet) very user-friendly: meaning, while installing you can't "go back" to change a (maybe misspelled) configuration or start the installation new without risking corrupted data.

Framework usage

The faktura web-application makes use of the following frameworks:

• The Kohana PHP framework v3.3.1
• The Boostrap CSS framework v3.2.0 (+ some themes from Bootswatch)
• The MooTools Core javascript framework v1.4.5
• The MooTools More javascript framework v1.4.0.1
• The MooTools Datepicker v1.6.0
• Respond.js
• The FontAwesome icon font v4.0.3
• The Smarty template engine v3.1.18
• The Swift Mailer library v5.2.0

faktura's Issues

Update customer selection inside invoice form

Instead of the "searchable" select field there should be something with more data available - Something like a popup with a table inside (which displays customer name, contact person, address, ...).

There should be more template plugins - Like for example "searchable select" (already done), "popup selection" (for customers, invoices, suppliers), ...

Refactor the dashboard - make it customizable

The dashboard should be refactored to single "widget"-classes and views, so that they can be handled individually. Also, when this is done, it should be customizable - meaning each user should be able to define his or her own dashboard...

• Which widgets shall be displayed
• position of widgets
• widget options (to come)

Updater needs to update "base" configuration

Currently the updater only updates the database, but neither the application version or the configuration files. This can lead to errors:

• When downloading and overwriting the "application" folder the update will not be triggered, because the SYSTEM_VERSION constant will already be set to 1.1.0.
• Also there will be javascript errors (after the update), caused by PHP warnings. These PHP warnings only occur because the "base" config is not updated - which results in missing configuration keys.

Charts missing

Hi
Cool tool. but one small question: charts do not work because of the missing js. Which charts were you using?

thanks.

Change "factura" to "faktura" wherever it occurs

The applications name is "faktura" with a "k" ... So all variables, translations and so on should be spelled the correct way!

New template plugin: Popup for detailed selection

Just like the popup for selecting single invoice positions for the "credit" print view. Maybe it can just be "refactored"?

Implement a theme switcher

Currently the faktura uses a bootstrap theme from bootswatch. So it should be quite simple to implement other themes!

It would be nice if every user could choose his/her own theme (update the users table).

Implement a template engine

I'd really like to implement a template engine to clean up all the views and make the print templates "more easy" to use. Also the engine should support multiple languages. It should definitely be very lightweight without too much overhead!

• RainTPL
• Mustache
• Smarty (not really "lightweight")

... Any suggestions?

Create a "update" routine

We definitely need a "update" routine, which should work just as easy as the setup wizard. Maybe even automated?

"forgot password" function

For this feature it would be great to have a solid mailer class (swiftmailer?) and maybe even more configurations (SMTP, PHP Mail, ...).

Create a "popup" plugin

In order to use modal popups all over the application, there should be a global "ModalPopup" class with methods like...

• initialize (should be called in the _base template)
• open
• close
• load (to load content via AJAX)
• grab (to grab an existing element and display it)
• responsive (for observing size-changes and updating the width)

Change from PHP to smarty as a template engine

So now that smarty is implemented and already being used for the email templates "the rest" should be converted.

bootstrap anpassung

in der bootstrap.css
h3,.h3{font-size:26px} auf h3,.h3{font-size:20px} setzen

Search by multiple words

So the internal search is working quite good and fast - but it's not possible to search for "company a" and "city b" in one ("company a city b"). The internal search needs to work with brackets for this:

Instead of :

$customers = ORM::factory('customer')
   ->where('name', 'LIKE', '%' . $search . '%')
   ->or_where('company', 'LIKE', '%' . $search . '%')
   ->or_where('email', 'LIKE', '%' . $search . '%')
   ->or_where('street', 'LIKE', '%' . $search . '%')
   ->or_where('zip_code', 'LIKE', '%' . $search . '%')
   ->or_where('city', 'LIKE', '%' . $search . '%')
   ->find_all();

Rather use:

$search = explode(' ', $search);
$customers = ORM::factory('customer');

foreach ($search as $searchword)
{
   // Here we work with brackets for matching.
   $customers->and_where_open()
      ->where('name', 'LIKE', '%' . $searchword . '%')
      ->or_where('company', 'LIKE', '%' . $searchword . '%')
      ->or_where('email', 'LIKE', '%' . $searchword . '%')
      ->or_where('street', 'LIKE', '%' . $searchword . '%')
      ->or_where('zip_code', 'LIKE', '%' . $searchword . '%')
      ->or_where('city', 'LIKE', '%' . $searchword . '%')
      ->and_where_close();
} // foreach

$customers = $customers->find_all();

Change the language inside the GUI

Users should be able to change the language inside their profile (add a "language" field to the user-table?)

Problem after installation

Hi,
I have a problem after installation,
After install wizard, system redirect to /user all the time, but /user - 404 not found.
I have no idea what else I can do.
I've trayed to install all frameworks, but with out luck.

Use "master password" to reset the admin user

In case a user removes his own credentials, there should be a "master password" (maybe stored in the auth-config?) to reset the current user.

Update the setup routine

It should be possible to define the "base" configuration during the installation:

• faktura branding (headline / titlebar)
• timezone
• locale / language
• date-format for lists and forms
• minimum length of search strings
• how many rows per page (pagination)
• start number for invoices
• minimum password length