Contributing to nextcloud.com website
Please take a moment to review this document in order to make the contribution
process easy and effective for everyone involved.
Setup of a local development environment
Manual setup
- Install Wordpress >= 3.8.1
- Must be in the document root of the webserver (otherwise images won't load :( )
- Enter what you like for site title, admin user and password, none of this is stored in git
- Setup the repository
- Clone the repository in a folder of your choice
git clone git@github.com:nextcloud/nextcloud.com next
- In the wordpress installation in the
wp-content/themes
folder, create a link to the folder you just cloned the repository in under the name 'next'
- Activate the theme in
Appearance > Themes
- Import the website
content.xml
file
- First install the Wordpress Import Plugin (via
Tools > Import > Wordpress Import
> Install Plugin
)
- Select the
content.xml
file from the repository and click upload
- Select Import
- Copy over
config.php.sample
to config.php
and adjust settings as necessary (defaults will work just fine for local environments)
Development Process
- Fork the repository
- Setup your local development environment using the instructions above, changing the remote origin url
- Submit a pull request to master, on github once the feature/bugfix is complete
- After review (usually following one or two thumbs up), somebody from Nc marketing merges (typically @jospoortvliet )
- Deployment on nextcloud.com is handled manually by @jospoortvliet or the Nextcloud sysadmins including @LukasReschke
Notes
- If you are changing SCSS files during development, following command for automatic compilation is recommended:
sass --watch [location to scss files]
- Only Nc marketing merges things
Testing
The list below covers most pages on our site, copy it in a PR that needs site-wide testing, so one can just quickly click the links and check all pages. This is assuming you have a local setup on 127.0.0.1 for testing - we sadly have no working staging server.