From 0571e91ee327c886632d92c6900d85fb91b90501 Mon Sep 17 00:00:00 2001 From: Hillel Coren Date: Wed, 7 Dec 2016 23:16:11 +0200 Subject: [PATCH] Added basic custom modules docs --- docs/custom_modules.rst | 57 +++++++++++++++++++++++++++++++++++++++++ docs/index.rst | 5 ++-- 2 files changed, 60 insertions(+), 2 deletions(-) create mode 100644 docs/custom_modules.rst diff --git a/docs/custom_modules.rst b/docs/custom_modules.rst new file mode 100644 index 000000000000..baa664acca42 --- /dev/null +++ b/docs/custom_modules.rst @@ -0,0 +1,57 @@ +Custom Modules +============== + +Invoice Ninja support customs modules using https://github.com/nWidart/laravel-modules + +Install Module +"""""""""""""" + +To install a module run: + +.. code-block:: ruby + + php artisan module:install --type=github + +For example: + +.. code-block:: ruby + + php artisan module:install invoiceninja/sprockets --type=github + +You can check the current module status with: + +.. code-block:: ruby + + php artisan module:list + + +Create Module +""""""""""""" + +Run the following command to create a module: + +.. code-block:: ruby + + php artisan module:make + +.. Note:: To use the standard app layout change the top of Modules//Resources/views/index.blade.php to ``@extends('header')`` + +.. Tip:: You can specify the module icon by setting a value from http://fontawesome.io/icons/ for "icon" in modules.json. + +Share Module +"""""""""""" + +To share your module create a new project on GitHub and then commit the code: + +.. code-block:: ruby + + cd Modules/ + git init + git add . + git commit -m "Initial commit" + git remote add origin git@github.com:.git + git push -f origin master + +.. Tip:: Add ``"type": "invoiceninja-module"`` to the composer.json file to help people find your module. + +Finally, submit the project to https://packagist.org. diff --git a/docs/index.rst b/docs/index.rst index 411e67bf98ec..50c9a73efc29 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -36,11 +36,12 @@ Want to find out everything there is to know about how to use your Invoice Ninja data_visualizations api_tokens user_management - + .. _self_host: .. toctree:: :maxdepth: 1 :caption: Self Host - + + custom_modules iphone_app