Merge pull request #499 from nextcloud/skeleton-dir

Update skeleton dir guide
This commit is contained in:
Jos Poortvliet
2017-06-08 08:11:24 +02:00
committed by GitHub

View File

@@ -2,15 +2,21 @@
Providing Default Files
=======================
You may distribute a set of default files and folders to all users by placing
them in the :file:`nextcloud/core/skeleton` directory on your Nextcloud server.
These files appear only to new users after their initial login, and existing
users will not see files that are added to this directory after their first
login. The files in the :file:`skeleton` directory are copied into the users'
data directories, so they may change and delete the files without affecting the
originals.
You may distribute a set of default files and folders to all users by placing
them in directory that is readable by the webserver user. This allows you to
overwrite the files that are shipped by default with Nextcloud in
``core/skeleton``. That custom directory should then be configured in the
``config.php`` via the configuration option ``skeletondirectory`` (see
:doc:`../configuration_server/config_sample_php_parameters`). Leave
empty to not copy any skeleton files.
This screenshot shows a set of photos in the :file:`skeleton` directory.
These files will be copied only to new users after their initial login, and
existing users will not see files that are added to this directory after their
first login. The files in the ``skeleton`` directory are copied into the
users data directories, so they may change and delete the files without
affecting the originals.
This screenshot shows a set of photos in the ``skeleton`` directory.
.. image:: ../images/skeleton-files.png
@@ -18,12 +24,6 @@ They appear on the user's Nextcloud Files page just like any other files.
.. image:: ../images/skeleton-files1.png
Additional Configuration
------------------------
The configuration option ``skeletondirectory`` available in your
``config.php`` (See
:doc:`../configuration_server/config_sample_php_parameters`) allows
you to configure the directory where the skeleton files are located.
These files will be copied to the data directory of new users. Leave
empty to not copy any skeleton files.
.. note:: Overwriting the files in ``core/skeleton`` is not recommended,
because those changes will be overwritten on the next update of the Nextcloud
server.