From 9b361acdc6bc375533f99bd13eab8b759917e3c1 Mon Sep 17 00:00:00 2001 From: menelic Date: Tue, 12 Aug 2014 14:58:43 +0200 Subject: [PATCH 1/8] Create installing_apps.rst I suggest to amend the documentation and add the following to the apps.owncloud.com website as well. Since this is a new section and describes issues under active discussion I am putting this up as an issue, inviting comments and corrections as well as instructions from the maintainers as to where exactly this might be placed in the documentation. --- user_manual/installing_apps.rst | 15 +++++++++++++++ 1 file changed, 15 insertions(+) create mode 100644 user_manual/installing_apps.rst diff --git a/user_manual/installing_apps.rst b/user_manual/installing_apps.rst new file mode 100644 index 000000000..1386ae975 --- /dev/null +++ b/user_manual/installing_apps.rst @@ -0,0 +1,15 @@ +Installing Apps in OwnCloud + +ownCloud functionality can be enhanced by installing apps that run in the server instance and provide additional features such as a music player and server, single file encryption, an rss aggregator and many more. A repository of apps can be found at apps.owncloud.com, where apps are listed, ranked, discussed and offered for download. A small subsection of these apps can be downloaded and installed directly from the Apps menue inside ownCloud. The majority of these apps however needs to be installed manually by downloading the zipped app from the app repository, uploading and unpacking it inside the ownCloud server instance. Provided App and ownCloud version are compatible, a refresh of the app section will then show this app in the list of installable apps in a column at the left of the ownCloud webinterface. + +Security notice + +Only apps listed as installable form within ownCloud have undergone extensive security checks. All other apps are installed at the users own risk. Manually added apps are parsed by a code checker, apps found to request qestionable permissions are blocked from being installed. At the moment, there is no user facing message about this - the app just does not appear in the list of available apps. + +Trouble shooting + +If a manual app install fails, this could be due to the fact that + + you have downloaded a version incompatible with the ownCloud version in use + the app contains malicious code + there is a genuine bug in the app that prevents it from running Please refer to the comment section in apps.owncloud.com to check if others have raised similar problems. Note that the score and download numbers of an app are a helpful, but not a sufficient measure of the quality and security of an app. From 3c1a32555d5295f60dea071fc5bb8ee2dd4ea4a2 Mon Sep 17 00:00:00 2001 From: menelic Date: Tue, 12 Aug 2014 15:09:00 +0200 Subject: [PATCH 2/8] Update installing_apps.rst --- user_manual/installing_apps.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/user_manual/installing_apps.rst b/user_manual/installing_apps.rst index 1386ae975..04aae9083 100644 --- a/user_manual/installing_apps.rst +++ b/user_manual/installing_apps.rst @@ -12,4 +12,4 @@ If a manual app install fails, this could be due to the fact that you have downloaded a version incompatible with the ownCloud version in use the app contains malicious code - there is a genuine bug in the app that prevents it from running Please refer to the comment section in apps.owncloud.com to check if others have raised similar problems. Note that the score and download numbers of an app are a helpful, but not a sufficient measure of the quality and security of an app. + there is a genuine bug in the app that prevents it from running. Please refer to the comment section in apps.owncloud.com to check if others have raised similar problems. Note that the score and download numbers of an app are a helpful, but not a sufficient measure of the quality and security of an app. From 4dbdf14e3e9639e634504e92d1eb3b0999c4e24e Mon Sep 17 00:00:00 2001 From: menelic Date: Tue, 12 Aug 2014 15:13:14 +0200 Subject: [PATCH 3/8] Update installing_apps.rst --- user_manual/installing_apps.rst | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/user_manual/installing_apps.rst b/user_manual/installing_apps.rst index 04aae9083..5f60cd30e 100644 --- a/user_manual/installing_apps.rst +++ b/user_manual/installing_apps.rst @@ -1,15 +1,15 @@ -Installing Apps in OwnCloud +#Installing Apps in OwnCloud ownCloud functionality can be enhanced by installing apps that run in the server instance and provide additional features such as a music player and server, single file encryption, an rss aggregator and many more. A repository of apps can be found at apps.owncloud.com, where apps are listed, ranked, discussed and offered for download. A small subsection of these apps can be downloaded and installed directly from the Apps menue inside ownCloud. The majority of these apps however needs to be installed manually by downloading the zipped app from the app repository, uploading and unpacking it inside the ownCloud server instance. Provided App and ownCloud version are compatible, a refresh of the app section will then show this app in the list of installable apps in a column at the left of the ownCloud webinterface. -Security notice +#Security notice Only apps listed as installable form within ownCloud have undergone extensive security checks. All other apps are installed at the users own risk. Manually added apps are parsed by a code checker, apps found to request qestionable permissions are blocked from being installed. At the moment, there is no user facing message about this - the app just does not appear in the list of available apps. -Trouble shooting +#Trouble shooting If a manual app install fails, this could be due to the fact that - you have downloaded a version incompatible with the ownCloud version in use - the app contains malicious code - there is a genuine bug in the app that prevents it from running. Please refer to the comment section in apps.owncloud.com to check if others have raised similar problems. Note that the score and download numbers of an app are a helpful, but not a sufficient measure of the quality and security of an app. + *you have downloaded a version incompatible with the ownCloud version in use + *the app contains malicious code + *there is a genuine bug in the app that prevents it from running. Please refer to the comment section in apps.owncloud.com to check if others have raised similar problems. Note that the score and download numbers of an app are a helpful, but not a sufficient measure of the quality and security of an app. From 675fff7857f02dd81e1b5fe96537154884b5824d Mon Sep 17 00:00:00 2001 From: menelic Date: Tue, 12 Aug 2014 15:15:44 +0200 Subject: [PATCH 4/8] Update installing_apps.rst --- user_manual/installing_apps.rst | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/user_manual/installing_apps.rst b/user_manual/installing_apps.rst index 5f60cd30e..0cd89a7f9 100644 --- a/user_manual/installing_apps.rst +++ b/user_manual/installing_apps.rst @@ -1,15 +1,15 @@ -#Installing Apps in OwnCloud +# Installing Apps in OwnCloud ownCloud functionality can be enhanced by installing apps that run in the server instance and provide additional features such as a music player and server, single file encryption, an rss aggregator and many more. A repository of apps can be found at apps.owncloud.com, where apps are listed, ranked, discussed and offered for download. A small subsection of these apps can be downloaded and installed directly from the Apps menue inside ownCloud. The majority of these apps however needs to be installed manually by downloading the zipped app from the app repository, uploading and unpacking it inside the ownCloud server instance. Provided App and ownCloud version are compatible, a refresh of the app section will then show this app in the list of installable apps in a column at the left of the ownCloud webinterface. -#Security notice +# Security notice Only apps listed as installable form within ownCloud have undergone extensive security checks. All other apps are installed at the users own risk. Manually added apps are parsed by a code checker, apps found to request qestionable permissions are blocked from being installed. At the moment, there is no user facing message about this - the app just does not appear in the list of available apps. -#Trouble shooting +# Trouble shooting If a manual app install fails, this could be due to the fact that - *you have downloaded a version incompatible with the ownCloud version in use - *the app contains malicious code - *there is a genuine bug in the app that prevents it from running. Please refer to the comment section in apps.owncloud.com to check if others have raised similar problems. Note that the score and download numbers of an app are a helpful, but not a sufficient measure of the quality and security of an app. ++you have downloaded a version incompatible with the ownCloud version in use ++the app contains malicious code ++there is a genuine bug in the app that prevents it from running. Please refer to the comment section in apps.owncloud.com to check if others have raised similar problems. Note that the score and download numbers of an app are a helpful, but not a sufficient measure of the quality and security of an app. From 6151b8f32b6539a9a293b1934a49390a50e83b8b Mon Sep 17 00:00:00 2001 From: menelic Date: Tue, 12 Aug 2014 15:16:36 +0200 Subject: [PATCH 5/8] Update installing_apps.rst --- user_manual/installing_apps.rst | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/user_manual/installing_apps.rst b/user_manual/installing_apps.rst index 0cd89a7f9..59e95b5b1 100644 --- a/user_manual/installing_apps.rst +++ b/user_manual/installing_apps.rst @@ -11,5 +11,9 @@ Only apps listed as installable form within ownCloud have undergone extensive se If a manual app install fails, this could be due to the fact that +you have downloaded a version incompatible with the ownCloud version in use + +the app contains malicious code -+there is a genuine bug in the app that prevents it from running. Please refer to the comment section in apps.owncloud.com to check if others have raised similar problems. Note that the score and download numbers of an app are a helpful, but not a sufficient measure of the quality and security of an app. + ++there is a genuine bug in the app that prevents it from running. + +Please refer to the comment section in apps.owncloud.com to check if others have raised similar problems. Note that the score and download numbers of an app are a helpful, but not a sufficient measure of the quality and security of an app. From 8dfd162f837eac0c4ecf30972df651ea69b89853 Mon Sep 17 00:00:00 2001 From: menelic Date: Tue, 9 Sep 2014 15:02:05 +0200 Subject: [PATCH 6/8] Update installing_apps.rst --- user_manual/installing_apps.rst | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/user_manual/installing_apps.rst b/user_manual/installing_apps.rst index 59e95b5b1..5fb900f89 100644 --- a/user_manual/installing_apps.rst +++ b/user_manual/installing_apps.rst @@ -1,12 +1,12 @@ -# Installing Apps in OwnCloud +# Installing Apps in ownCloud -ownCloud functionality can be enhanced by installing apps that run in the server instance and provide additional features such as a music player and server, single file encryption, an rss aggregator and many more. A repository of apps can be found at apps.owncloud.com, where apps are listed, ranked, discussed and offered for download. A small subsection of these apps can be downloaded and installed directly from the Apps menue inside ownCloud. The majority of these apps however needs to be installed manually by downloading the zipped app from the app repository, uploading and unpacking it inside the ownCloud server instance. Provided App and ownCloud version are compatible, a refresh of the app section will then show this app in the list of installable apps in a column at the left of the ownCloud webinterface. +ownCloud functionality can be enhanced by installing apps that run in the server instance and provide additional features such as a music player and server, single file encryption, an RSS aggregator and many more. An app repository can be found at apps.owncloud.com, where apps are listed, ranked, discussed and offered for download. A small subsection of these apps can be downloaded and installed directly from the Apps menu inside ownCloud. The majority of these apps however needs to be installed manually by downloading the zipped app from the app repository, uploading and unpacking it inside the ownCloud server instance. Provided App and ownCloud version are compatible, a refresh of the app section will then show this app in the list of installable apps in a column at the left of the ownCloud web interface. # Security notice -Only apps listed as installable form within ownCloud have undergone extensive security checks. All other apps are installed at the users own risk. Manually added apps are parsed by a code checker, apps found to request qestionable permissions are blocked from being installed. At the moment, there is no user facing message about this - the app just does not appear in the list of available apps. +Only apps listed as installable form within ownCloud have undergone extensive security checks. All other apps are installed at the users' own risk. Manually added apps are parsed by a code checker, apps found to request questionable permissions are blocked from being installed. At the moment, there is no user facing message about this - the app just does not appear in the list of available apps. -# Trouble shooting +# Troubleshooting If a manual app install fails, this could be due to the fact that From ce542f686e9b47b7b573e1067d64b13ba07f6f5c Mon Sep 17 00:00:00 2001 From: menelic Date: Tue, 9 Sep 2014 15:05:59 +0200 Subject: [PATCH 7/8] Update installing_apps.rst typos corrected, app is lowercase, Apps menu is uppercase in keeping with the interface conventions - or so I thought? --- user_manual/installing_apps.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/user_manual/installing_apps.rst b/user_manual/installing_apps.rst index 5fb900f89..12663f6f5 100644 --- a/user_manual/installing_apps.rst +++ b/user_manual/installing_apps.rst @@ -1,6 +1,6 @@ # Installing Apps in ownCloud -ownCloud functionality can be enhanced by installing apps that run in the server instance and provide additional features such as a music player and server, single file encryption, an RSS aggregator and many more. An app repository can be found at apps.owncloud.com, where apps are listed, ranked, discussed and offered for download. A small subsection of these apps can be downloaded and installed directly from the Apps menu inside ownCloud. The majority of these apps however needs to be installed manually by downloading the zipped app from the app repository, uploading and unpacking it inside the ownCloud server instance. Provided App and ownCloud version are compatible, a refresh of the app section will then show this app in the list of installable apps in a column at the left of the ownCloud web interface. +ownCloud functionality can be enhanced by installing apps that run in the server instance and provide additional features such as a music player and server, single file encryption, an RSS aggregator and many more. An app repository can be found at apps.owncloud.com, where apps are listed, ranked, discussed and offered for download. A small subsection of these apps can be downloaded and installed directly from the Apps menu inside ownCloud. The majority of these apps however needs to be installed manually by downloading the zipped app from the app repository, uploading and unpacking it inside the ownCloud server instance. Provided app and ownCloud version are compatible, a refresh of the app section will then show this app in the list of installable apps in a column at the left of the ownCloud web interface. # Security notice From 928835c963da46d53b5bc69ce8f44584fc0aa11b Mon Sep 17 00:00:00 2001 From: menelic Date: Mon, 27 Oct 2014 12:13:20 +0100 Subject: [PATCH 8/8] Update installing_apps.rst --- user_manual/installing_apps.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/user_manual/installing_apps.rst b/user_manual/installing_apps.rst index 12663f6f5..c0c90e1b6 100644 --- a/user_manual/installing_apps.rst +++ b/user_manual/installing_apps.rst @@ -12,7 +12,7 @@ If a manual app install fails, this could be due to the fact that +you have downloaded a version incompatible with the ownCloud version in use -+the app contains malicious code ++the app has been rejected by the internal app code checker +there is a genuine bug in the app that prevents it from running.