|Nextcloud bot 7516ece0bf [tx-robot] updated from transifex||1 day ago|
|.github||1 month ago|
|.tx||1 year ago|
|appdata||1 week ago|
|appdata_public||4 months ago|
|appinfo||2 days ago|
|css||4 weeks ago|
|img||2 years ago|
|js||2 weeks ago|
|l10n||1 day ago|
|lib||2 days ago|
|screenshots||1 week ago|
|templates||1 week ago|
|tests||6 days ago|
|.gitattributes||1 month ago|
|.gitignore||3 months ago|
|.phpcs.xml||3 months ago|
|.scrutinizer.yml||2 days ago|
|LICENSE||2 years ago|
|Makefile||2 days ago|
|README.md||1 week ago|
|composer.json||1 week ago|
|composer.lock||1 week ago|
Pico CMS for Nextcloud combines the power of Pico and Nextcloud to create simple, secure, shareable and amazingly powerful websites with just a few clicks. Pico is a stupidly simple, blazing fast, flat file CMS - making the web easy!
Installing Pico CMS for Nextcloud allows your users to create and manage their own websites. Creating a new page with Pico is no more than creating a simple text file in a users’ Nextcloud files. No config is required, no utterly complex management interfaces - just files. It’s the perfect match with Nextcloud. Secure Sharing, Collaboration, Access Control - not just for your files, but also your websites, all made possible by Pico CMS for Nextcloud! Breaking the boundaries between your Mobile & Desktop devices and your Server.
Websites will be accessible through URLs like https://cloud.example.com/sites/my_site/ and consist of just a bunch of
.md text files in a user’s Nextcloud files.
.md stands for Markdown - a super simple and intuitive markup to create headings, paragraphs, text formatting, lists, images and links. But don’t despair - you don’t have to learn yet another language if you don’t want to. Consider enabling Nextcloud’s Text or Markdown Editor apps to make easy things stupidly simple. But what about meta data like a page’s title or release date? Guess right, it’s all in one place. At the top of your Markdown files you can place a block with such meta data - called the YAML Front Matter. Creating websites can’t be easier…
But that wasn’t everything… Pico CMS for Nextcloud is highly customizable. You can change Pico’s appearance by using custom themes and add new functionality by using custom plugins. For security reasons users can neither add custom themes nor plugins on their own - but as an admin you can. Plugins and themes aren’t just new “skins” or “widgets”, the underlying technologies are powerful frameworks you can leverage to make your users’ websites truly unique. However, with great power comes great responsibility. Pico CMS for Nextcloud does its best to prevent users from including scripts into websites, since this might bear security risks (so called “Cross Scripting”). Since this risk doesn’t apply to Pico itself, 3rd-party developers of plugins and themes might not be aware of this issue - so be careful when installing custom plugins and themes.
You want to learn more about Pico CMS for Nextcloud? Easy! Just download and enable the app from Nextcloud’s App Store and create your first personal website using the “sample_pico” template. Pico’s sample contents will explain all you need to know… :wave:
Pico CMS for Nextcloud can be found in Nextcloud’s App Store. Installing the app using the app store is super easy: Simply navigate to the Apps management page of your Nextcloud and either search for “Pico CMS” or check the “Tools” section to find Pico CMS for Nextcloud. Hit the “Download and enable” button and you’re ready to go!
Open a shell and navigate to Nextcloud’s install directory (e.g.
/var/www/html/nextcloud). Clone Pico CMS for Nextcloud’s Git repository to your
$ git clone https://github.com/nextcloud/cms_pico.git apps/cms_pico
composer install to install the app’s dependencies. If you haven’t installed Composer yet, you must download it first.
$ cd apps/cms_pico/ $ curl -sSL https://getcomposer.org/installer | php $ php composer.phar install
Make sure that your webserver has write permissions on the app’s
appdata_public/ directory. You can ensure this by matching the permissions (owner, group and permissions) of Nextcloud’s
$ chown --reference=../../data/ appdata_public $ chmod --reference=../../data/ appdata_public
Something went wrong? You need help? No worries, we will help!
If you want to get started using Pico, please refer to Pico’s user docs. You can find officially supported plugins and themes on Pico’s website. A greater choice of third-party plugins and themes can be found in Pico’s wiki on the plugins or themes pages respectively. If you want to create your own plugin or theme, please refer to the “Getting Help as a developer” section of Pico’s docs.
When the docs can’t answer your question, you can get help by either joining us on #picocms on Freenode IRC (logs), or by creating a new thread on Nextcloud Help. When you’re experiencing problems with Pico CMS for Nextcloud, please don’t hesitate to create a new Issue on GitHub. Concerning problems with plugins or themes, please refer to the website of the developer of this plugin or theme.
Before creating a new Issue, please make sure the problem wasn’t reported yet using GitHubs search engine and the search of Nextcloud Help. Please describe your issue as clear as possible and always include the version of Pico CMS for Nextcloud you’re using. Provided that you’re using custom plugins and/or themes, include a list of them too. We need information about the actual and expected behavior , the steps to reproduce the problem, and what steps you have taken to resolve the problem by yourself (i.e. your own troubleshooting).