Nextcloud Folder List
Conveniently display Nextcloud folder content on your WordPress site - without cumbersome configuration.
Functions at a glance
With the Nextcloud Folder List plugin, you can configure various Nextcloud folders and insert them into your WordPress posts or pages using shortcodes. This is how you present PDF documents, image galleries or classic file lists directly on your website.
-
PDF list
Display PDF documents from the configured folder. Open PDFs directly in an embedded embedded viewer or download them for downloading.
-
Gallery mode
Displays image folders as a gallery with configurable columns. Perfect for displaying photo albums clearly arranged.
-
List mode
Classic file list with "Back" button, metadata (file size, date) and download links.
-
Shortcode flexibility
You can simply insert a folder view per instance in WordPress posts or pages via shortcode.
Shortcode attributes
- type:
gallery|pdf|list - per_page: 20 - For Gallery: Number of images per page
- columns: 4 - Only for Gallery: Number of columns
Example: For a 4×4 grid gallery: type="gallery" per_page="16" columns="4"
Example views
Some examples of what the different display modes could look like:
PDF list in the embedded viewer
Gallery mode with 4 columns
Classic file list with metadata
Caching to protect your Nextcloud
The plugin uses an intelligent caching system to minimize repeated accesses to your Nextcloud API. are minimized. This reduces the server load and shortens the loading times of your page. Settings for the cache:
- Cache duration configurable (e.g. 5 minutes, 1 hour, 1 day) TODO: implement
- Fallback mechanism if the connection to Nextcloud is lost
Simple operability
Our plugin has been developed so that you can get started in just a few steps:
- Install plugin:Install and activate the plugin via the official WordPress plugin store (TODO: Link)
- Configure folder:Enter the URL, user name and Nextcloud password as well as the folder path.
- Insert shortcode: Copy
[nc_listing id="1" type="gallery" per_page="8" columns="2"]in your contribution. - Display and customize: Adjust the number of columns, sorting or page size as required.
No programming knowledge required - all settings are made via the WordPress dashboard.
Example use cases
Internal documentation
Display company guidelines or manuals as a PDF list. Employees can access documents directly access documents directly in the browser without having to open Nextcloud individually.
Photo gallery
Present event images or product photos as an appealing gallery.
Download portal
Provide software downloads, white papers or resources in a clearly organized file list including metadata and direct download links. Changes in the Nextcloud folders are automatically visible on your Worpress site.
Frequently asked questions (FAQ)
Here you will find answers to frequently asked questions. If your question is not listed, please contact support.
➤ How do I set up the plugin for the first time?
Answer: After installation, you can link as many Nextcloud folders as you like and integrate them into your site as shortcodes.
➤ Can I display several folders at the same time?
Answer: Yes, create a new listing instance in the plugin for each folder and use the corresponding shortcode IDs.
➤ Does the plugin also support public Nextcloud folders?
Answer: You currently need valid Nextcloud access data. For public folders, check whether your Nextcloud instance allows anonymous access.
➤ Can I deactivate or customize caching?
Answer: You can change the cache duration in the plugin settings or deactivate it completely if required. TODO: implement
➤ How do I change the number of columns in the gallery afterwards?
Answer: Simply change the attribute columns="X" in the shortcode and save the post again.
➤ Isn't it very insecure to store my access data?
Answer: Your access data is stored in encrypted form and is only used on the server side. However, we recommend creating a new Nextcloud account for folders to be shared in order to protect sensitive data as much as possible. 1. create a new account. 2. share the access rights to selected folders that you want to display in WordPress with this new account. 3. store the access data of the new account in the folder configuration
English 
Deutsch