You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Nextcloud bot 7516ece0bf
[tx-robot] updated from transifex
1 day ago
.github Add .github/CONTRIBUTING.md 1 month ago
.tx Fix tx config 1 year ago
appdata content/_meta.md: Update default tagline 1 week ago
appdata_public Add missing appdata_public/.gitignore 4 months ago
appinfo Bump to version 1.0.2 2 days ago
css Fix Nextcloud 17 CSS 4 weeks ago
img Admin+Section - #6 2 years ago
js Improve JSDoc class docs 2 weeks ago
l10n [tx-robot] updated from transifex 1 day ago
lib Add TODOs for Nextcloud 18 2 days ago
screenshots Update screenshots/website.png 1 week ago
templates fix nginx sample config 1 week ago
tests Split SettingsController into {Settings,Themes,Plugins,Templates}Controller 6 days ago
.gitattributes Update .gitattributes and Makefile excludes 1 month ago
.gitignore Replace Nextcloud Drone by Scrutinizer 3 months ago
.phpcs.xml Replace Nextcloud Drone by Scrutinizer 3 months ago
.scrutinizer.yml Scrutinizer CI: Increase phpunit idle timeout to 20 minutes 2 days ago
LICENSE license & copyright 2 years ago
Makefile Makefile: Add 'check-composer' target 2 days ago
README.md README.md: Add "Getting help" section, remove "Configuration" section 1 week ago
composer.json Update to Pico 2.1.0 1 week ago
composer.lock Update to Pico 2.1.0 1 week ago

README.md

Pico CMS for Nextcloud

Latest Release Build Status Scrutinizer Code Quality Code Coverage

About

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!

  • :notebook: Start a blog
  • :rocket: Share your resume with the world
  • :smiling_imp: Create a plan for world domination and only share with the right friends
  • :neckbeard: Build a knowledge base and let the smart ones among your colleagues help out

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:

Installation

App Store

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!

Manually

  1. 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 apps/cms_pico/ directory:

    $ git clone https://github.com/nextcloud/cms_pico.git apps/cms_pico
    
  2. Run 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
    
  3. 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 data/ directory:

    $ chown --reference=../../data/ appdata_public
    $ chmod --reference=../../data/ appdata_public
    

Getting help

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).