From dde067c2dc96a0f450cbada3e05f3b4d2eec5201 Mon Sep 17 00:00:00 2001 From: Marcel Robitaille Date: Wed, 9 Feb 2022 17:47:26 -0400 Subject: [PATCH 1/2] Add documentation for developping an existing app MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The App development ยป Introduction documentation only discusses how to create a new app. Wanting to contribute to an existing app, I was confused by this. Once I figured out how to set everything up so that I could see my changes to the app in my development version of Nextcloud, I thought I would make this pull request to add this information to the docs. Signed-off-by: Marcel Robitaille --- developer_manual/app_development/intro.rst | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/developer_manual/app_development/intro.rst b/developer_manual/app_development/intro.rst index 6f034836e..b69f6125a 100644 --- a/developer_manual/app_development/intro.rst +++ b/developer_manual/app_development/intro.rst @@ -13,6 +13,17 @@ After :doc:`you've set up the development environment <../getting_started/devenv Then create a skeleton app in the `app store `_. This doesn't publish anything on the appstore yet, it just gives you a download. +Edit an existing app +-------------------- + +Alternatively, if you would like to contribute to an existing app instead of creating a new one, first :doc:`set up the development environment <../getting_started/devenv>`, then change into the Nextcloud apps directory:: + + cd /var/www/nextcloud/apps + +Finally, clone the app to which you would like to contribute. For example: + + git clone https://github.com/nextcloud/cookbook.git + Enable the app -------------- The app can now be enabled on the Nextcloud apps page. From efe787166c827339f9a1bffa92e1cff26d600c5a Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?John=20Molakvo=C3=A6?= Date: Sat, 13 Aug 2022 13:05:59 +0200 Subject: [PATCH 2/2] Update developer_manual/app_development/intro.rst Co-authored-by: Carl Schwan --- developer_manual/app_development/intro.rst | 24 +++++++++++++++++++--- 1 file changed, 21 insertions(+), 3 deletions(-) diff --git a/developer_manual/app_development/intro.rst b/developer_manual/app_development/intro.rst index b69f6125a..6fde12b4f 100644 --- a/developer_manual/app_development/intro.rst +++ b/developer_manual/app_development/intro.rst @@ -16,11 +16,29 @@ Then create a skeleton app in the `app store `, then change into the Nextcloud apps directory:: +Alternatively, if you would like to contribute to an existing app instead of creating a new one, first :doc:`set up the development environment <../getting_started/devenv>`, then create an `apps-extra` folder in the Nextcloud root directory:: - cd /var/www/nextcloud/apps + cd /var/www/nextcloud/apps-extra -Finally, clone the app to which you would like to contribute. For example: +You can then configure Nextcloud to run apps from this directory, by changing your `app_paths` system config in your `config.php` + + 'apps_paths' => + array ( + 0 => + array ( + 'path' => '/var/www/html/apps', + 'url' => '/apps', + 'writable' => false, + ), + 1 => + array ( + 'path' => '/var/www/html/apps-extra', + 'url' => '/apps-extra', + 'writable' => false, + ), + ), + +Finally, clone the app to which you would like to contribute inside the `apps-extra` folder. For example: git clone https://github.com/nextcloud/cookbook.git