owncloud-archive/owncloud.org

:globe_with_meridians: Development repository for the owncloud.org website

Contributing to ownCloud.org website

Please take a moment to review this document in order to make the contribution process easy and effective for everyone involved.
https://doc.owncloud.org is not maintained here, but in https://github.com/owncloud/documentation

This repo contains the Wordpress theme for owncloud.org. To setup a (development) environment please note the following.

The theme is work in progress. Some contents are still hardcoded and not cms'ified yet.

Mandatory Plugins

Advanced Custom Fields (ACF) Pro

Install the plugin and import https://github.com/owncloud/owncloud.org/blob/master/acf-export.json

If the custom fields are changed in production please export the custom fields setup and overwrite the acf-export.json file.

WP_SCSS

Processor for SCSS files. SCSS directory: /scss/ CSS directory: /css/ Compiling Mode: Crunched Source Map Mode: None Error Display: Show to logged in users Enqueue Stylesheets: Yes

Co-Authors Plus

https://wordpress.org/plugins/co-authors-plus/ Enables multiple authors on articles

Custom Post Type UI

Handles the administration of custom post types. Please see custom_post_types_export.txt. Import this file to set up all custom post types. If custom post types are changed in production please export and overwrite the file custom_post_types_export.txt.

Shield

https://wordpress.org/plugins/wp-simple-firewall/

Not feature but security relevant. Most important settings are:

• hide standard wordpress login page (URL changer)
• enable 2FA
• enable Bruteforce protection

Less critical plugins

The following plugins are needed for some features but do not impair the websites basic features.

WP Fastest Cache (Pro)

Caches pages for faster content delivery and optimizes script compression and loading. Note that for production environment the /changelog/ URL must be entered as URL rule to not be cached (see "Auto-pull of Changelogs" below)

YOAST! SEO

Mandatory for SEO and page loading optimization.

Recent Tweets Widget

https://wordpress.org/plugins/recent-tweets-widget/

Includes recent tweets from a twitter channel

Contact Form 7

https://wordpress.org/plugins/contact-form-7/

Easily set up contact forms

Material Design for Contact Form 7

https://wordpress.org/plugins/material-design-for-contact-form-7/

Design addon for Contact Forms 7 There are some custom changes on this plugin:

plugins/material-design-for-contact-form-7/freemius/includes/class-freemius.php: remove line 3014: Avoid API call which slows down DB

plugins/material-design-for-contact-form-7/admin/cf7-material-design-admin.php: remove line line 28: Prevent DB performance decrease

This needs to be considered if the plugin gets updated!

Public Post Preview

https://wordpress.org/plugins/public-post-preview/

Enables post preview links

Customizations

Auto-pull of Changelogs

The pages on https://owncloud.org/changelog/ are pulled via cronjob from (for example "server") https://raw.githubusercontent.com/owncloud/core/stable10/CHANGELOG.md

See https://github.com/owncloud/owncloud.org/blob/78f1d3a56b77c4c9fdf0df345776b502525d8e13/functions.php#L259

These pages must not be cached, see the WP Fastest Cache Settings above.

owncloud.org's Issues

Server download link mentions Mac OS

Although Mac OS X is not supported by owncloud server (only by the clients)

http://owncloud.org/install/
"Download Unix/Mac OS (.tar.bz2) or Windows (.zip) archive.

Update desktop client screenshot

http://staging.owncloud.org/install/ uses a mac screenshot of 1.5, which looks really ugly compared to 1.6. Let's update that before launch.

a public wiki for doc

Hi, i woud like to request a public wiki for the dev doc.

As an average coder and a OC noob, im having a hard time to understand your dev doc (its maybe just me). Once I figure/found something out. I always feel that i shoud publish code snippet or more/bether explications.

So a comunity wiki beside or with official doc woud help a lot.
As an example see the archlinux wiki

I aslo really find this site usefull for dev: http://fossies.org/dox/owncloud-5.0.6/

Btw, thx for your work!, OC is moving fast, and becoming a solid player in the feld.

Contribution section of homepage

Frank's original comment:

I think our new homepage should have a stronger hint that ownCloud is developed by an open and volunteer community and everyone can join and help. Perhaps with some direct links how to submit a patch or a bug or a feature request. The "Get involved" section is a good start but should be clearer and perhaps more prominent.

@MariekevC and @jancborchardt Ideas on making this section larger / more prominent. What other content can we include to open it up?

@karlitschek

http://owncloud.org/developer/ still points to v5.0 developer manual

Although OC v6.0.0a has already been published the Developer Center still points to the latest v5.0 developer manual:

Spelling Mistake

http://doc.owncloud.org/ still points to the oc v5.0 documentation as last stable one.

Although OC v6.0.0a has already been published the default documentation link referrers to the v5.0 server as last stable version.

http://doc.owncloud.org/desktop forwards top 1.4 doc instead of 1.5

Removing documentation from website pages

@dragotin @danimo

Am redesigning the layout of the /install page to incorporate the sync clients page (see here).

The /sync-clients page doesn't really add any additional information (beside the testing links which I will move across).

The bulk of it is installation documentation in my opinion and should be moved to a more appropriate location which we can link to.

Do we already have installation documentation (like how to install it on mac...)? If not where should this be copied over?

Just had another look over the page and noticed the changelog. I think this should stay on owncloud.org somewhere as its not documentation as such. Agreed?

Thanks :)

Website migration

I'd like to open this issue to discuss the steps we need to take to move over the new website.

Mentioning relevant people: @karlitschek @danimo

The new website requires us to reinstall Wordpress with a clean database. Copy over the theme from this repository. Import the some wordpress data using the import tool. I suggest that while this happens, we put up a basic html message informing that we are upgrading the website.

Additionally, we need to update the documentation server. I am not sure what is involved in this process. @danimo could you elaborate please.

Finally there is the issue of time. @karlitschek I fear this may take time, of which I don't really have any for 4 weeks. Once it is launched there will inevitably be bugs which I won't be able to attend to straight away. Would we be better to push for this after my exams (13th June onwards?)

Provide a "latest" symlink for the documentation

Hi,

at the moment the version number of OC is used for the documentation like:

http://doc.owncloud.org/server/6.0/admin_manual/

It could be useful to provide a symlink like:

http://doc.owncloud.org/server/latest/admin_manual/

which links to:

http://doc.owncloud.org/server/6.0/admin_manual/

and after the release of OC 7 to:

http://doc.owncloud.org/server/7.0/admin_manual/

This could be used to always link to the latest available documentation on pages like the startpage of:

http://owncloud.org/

There links like the "Write code for the core" or "Write an ownCloud app" is currently linking to http://doc.owncloud.org/server/5.0/developer_manual/ even if the 6.0 version is the more recent one.

Fix OS X description on http://owncloud.org/sync-clients/

It mentions ownCloud-1.4.2.dmg although we are at 1.5.x
Better change it to something like "the downloaded disk image file" then you don't need to update it all the time.

apps.owncloud.org shows the api.owncloud.org website

http://apps.owncloud.org shows the http://api.owncloud.org website. It should probably redirect to http://apps.owncloud.com ?

[WIP] Conference page

Made a template for the conference and stuck some example content inside. @jancborchardt @MariekevC @jospoortvliet

Nav bar on mobile is partially covered

@MariekevC Now that we have an extra nav bar item 'Contribute' the nav on mobile is partially covered. Do we set the height somewhere manually?

Old doc directories should be added to robots.txt

If I google for
owncloud build client
the first hit is
http://doc.owncloud.org/desktop/1.2/building.html

We should block those old version directories so Google shows the 1.5 as current one.

Dead link on owncloud.org

On http://owncloud.org/developer/ there is a dead link in the sidebar pointing into the void:

• Security -> http://owncloud.org/about/security/ -> http://owncloud.org/security/policy

Advisories page

In the process of designing a template for the advisories page.

See

@LukasReschke @jancborchardt How can we spruce this up a bit?

Lukas liked (this)[http://framework.zend.com/security/advisory/ZF2014-01] design for an advisories page. I've copied the components across. Is this all we need?

RSS feed for releases

It would be extremely helpful to have an RSS feed of owncloud.org/changelog/ as a way to be notified of new releases. The normal news RSS has too much other information and minor releases are barely mentioned. Would this be possible?

Better storage format for changelog information

@danimo @karlitschek

Just for discussion. We should think about a better way to store our changelogs rather than very long html pages with, as Daniel said, lots of room for human error. From whatever storage format we choose we can generate html and any other required output formats, parse for errors etc...

Press page

I think at some point we should add a page on the website with some nice looking screenshots and logos for press to use. Otherwise we see these articles still appearing today using ownCloud 3.0 screenshots!

To include:

• High quality ownCloud.org logo (different sizes, formats?)
• Screenshots of main server apps (files, gallery, contacts....)
• Branding guidelines (use of the logo)

Link on http://owncloud.org/developer/ pointing to http://owncloud.org/contribute/

As the owncloud.org page is the first point of contact for potential contributors, the developer page should contain a link to the contribute page.

Gitorious still in place

http://owncloud.org/contribute/

Contribution guidelines
we use Github, get an account there and clone the ownCloud repository
...
when you are finished, use the merge request function on Gitorious.

Broken top nav for narrow devices

@MariekevC Do you reckon you could have a look at the styling on the top nav when the device is particularly narrow and the site changes to the button and drop down nav.

As shown in the image below, the menu items seem to be hugging the right hand side.

Thanks

RSS-Feed on owncloud.org/news is empty

This is basically a duplicate of: owncloud/core#2509

Expected behaviour

Go to http://owncloud.org/news/
See news

Actual behaviour

Go to http://owncloud.org/news/
See an empty RSS-Feed

Also link to /blog/ is a deadlink!

Justified text on homepage

Before:

After:

Thoughts @jancborchardt and @MariekevC ?

Install buttons scroll to pop up and background doesnt fill page

@MariekevC See attached screenshot, when first clicking on any of the install buttons the page scrolls to the top of the pop up, but the background does not fill the page.

Broken link on http://owncloud.org/developer/

On the http://owncloud.org/developer/ page is the ownCloud master (dev) link broken, as it points to http://doc.owncloud.org/server/master/developer_manual/ which states something like Error 404: File not found.

[WIP] Providers page

@jancborchardt Need some ideas of how to style the providers page.

See the current state: https://staging.owncloud.org/providers/

All of the banners we have are 290 x 70 pixels, which doesn't match the current 3 column framework. What do you think is the best solution?

@MariekevC You know a bit more than me I think about the bootstrap framework. Can we produce a custom sized (smaller) 3 column layout on this page to accommodate the banners better?

wrong owncloud link on github

Don't know if this is the place for this issue but if you want to change from the github owncloud homepage to page 2 or further of the repositories it tries to go to:
https://github.com/orgs/owncloud?page=2 where I think it should go to:
https://github.com/owncloud?page=2

Remove deprecated installation.html

Hi,

this was already reported at the documentation bugtracker: owncloud-archive/documentation#136 but i think this is just a leftover from the old documentation as the documentation repos doesn't contain this file anymore.

There are still some users which pointing to this file when having problems with NginX for example as they are using this old NginX config which doesn't work for OC5.

This file really should be removed from owncloud.org.

This file

wizard contains no PHP code

https://download.owncloud.com/download/community/setup-owncloud.php

this file just contains HTML, seems there are some header directives for a working download are missing on your side

Search results show page author

I don't think it is appropriate to show the author under each page on the search results in our use case. @MariekevC do you know which file generates this or is it some default Wordpress output we need to overwrite? In the old theme we used to have a file called content-searchresult.php that adjusted the output but that file doesn't seem to do anything now.

screen shot 2014-06-16 at 10 22 13

Loading Other JS Files

Developed a layout.gues.php theme. I have manually changed everything. The background in the CSS load correctly. However the javascript files which are dependent on the animated objects do not.

I have tried searching and even finding the defining php file for $jsfiles and without luck. I have not found a 'hack' to load the js files in my /theme/themename/js/ directory.

You guys were my last resort. Thanks.

https://www.owncloud.org redirects to https://owncloud.com/

Hi,

when connecting via https to https://www.owncloud.org a certificate warning is shown. If this is temporary accepted a redirect to https://owncloud.com/ is made.

Using https://owncloud.org works as expected and the owncloud.org webpage is shown.

[WIP] Documentation theme

Just got it to build, looks awesome thanks!

Only things I can spot that need changing are shown in the screenshot below:

(Space after the headings, and not sure what those links are at the top?)

Thanks!

Unit tests info outdated

http://owncloud.org/apps/unit-testing/

We use PHPUnit for a quite long time.

Wrong infos about sync-client 1.2.3

Hi,

on:

https://owncloud.org/sync-clients/

this text is shown:

The latest version of the client is version 1.2.3, released on february 26, 2013

The release date is the old release date from version 1.2.1

Additionally:

https://owncloud.org/sync-clients/releases/

shows only version 1.2.2 and not 1.2.3

:construction: [WIP] New Install Page

@jancborchardt @MariekevC

Thoughts on this install page: http://staging.owncloud.org/install/

Tried to copy over old page, but it didn't work on mobile at all. Also tried to remove the rather redundant /sync-clients page by including most of the detail here.

We should move over the installation instructions given on the existing /sync-clients page to the documentation repo.

»Apps« page

We should have a page with the best apps which work with ownCloud. I already collect apps on this wiki page: https://github.com/owncloud/core/wiki/Apps

There’s most probably stuff missing, please add that.

@tomneedham we should have an »Apps« page on the website where we list these apps, with icons and stuff. Can wait for after the initial deploy though.

Provide link for beta and nightlies

If we offer nightlies and betas, these should be available on the homepage directly on the download page.

This will prevent questions on the ML and issue tracker and help us getting more testers

http://owncloud.org/releases/owncloud-daily-master.tar.bz2

md5sum of download, false security.

I just noticed something that made me smile;

the owncloud tar.bz2 and the md5sum are both stores in the same dir on the same server. Which makes me wonder what the goal was of having the md5sum in the first place.
Any attacker able to compromise the tarball would have been able to also update the md5sum, so it adds no security. Just a false sense of security.
Notice that this doesn't have to mean an actual compromised download.o.o, simple proxy-server attack or dns-attack can do that job too.

I suggest that the md5sum is not just stored on the same server, but instead pasted in a html page on both the owncloud.org and owncloud.com webservers on the download page.
Duplication on both websites greatly helps early detection, but its optional.
It would be highly recommended to switch to https for that page as this secures against various known attacks.

This approach would actually add security, the current solution only gives a false sense of security.

Typo on the sync-clients web page

There's a typo in the first line on http://owncloud.org/sync-clients:

It's supposed to say "Specify one or more directories..." not "Specify one ore more directories..."

Thoughts on a slightly different homepage layout

In an attempt to bring some content higher up as the splash image fills a lot of the screen before the fold. I put this together using inspect elements in chrome so not much polishing but could do something like this:

@jancborchardt @MariekevC @karlitschek

Diaspora and identi.ca

Aren't they updated anymore? It seems there are no posts for 2 years.
Still accessible from here: http://owncloud.org/about/contact/

http://download.owncloud.com/desktop/testing/ - read folder

It'd be great to see a "nightly builds" list of sorts for past versions hosted here:

http://download.owncloud.com/desktop/testing/

Maybe just organize clean up the folder and put a +Indexes on the .htaccess?

ownCloud 7 Launch Task List

Tasks to be completed before the launch of the new website (along with ownCloud 7):

Content:

• Home page text
• Install page
• Contribute page
• Security page(advisories need porting, and php render code developed)
• Contact page
• Server Installation instructions on /install
• Add link to advisories page
• Add sync client testing information
• Update desktop client screenshot

Design:

• Documentation design
• Splash image adjustment
• Providers page

Tweaks:

• Fix images on history page
• Fix images on features page
• Move menus from Wordpress to php files (header)
• Move menus from Wordpress to php files (footer)

@jancborchardt @karlitschek @MariekevC

Changes to page locations and editing workflow: just FYI

Hi @karlitschek, @danimo, @dragotin,

Just an FYI for when we flip the switch on the new oc.org website. A few pages have changed in location, and the process for editing them is quite different. I know that the changelog and various bits and pieces around the website get changed when we release new versions. Hopefully this should be loads easier as I've implemented variables in all the relevant pages.

To update versions now all you need to do is make the change in strings.php: https://github.com/owncloud/www/blob/master/strings.php and all will be done for you :)

For both desktop and server sides there are various strings to represent the different versions available (daily, stable, testing etc). Adjusting the major stable version of the server will automatically change all of the documentation links to link to the newest stable version.

Also, the changelogs have changed location. As with the rest of the content, they are now stored in the git repo. Server is here https://github.com/owncloud/www/blob/master/page-changelog.php and desktop is here: https://github.com/owncloud/www/blob/master/page-desktop.php. I've adjusted the syntax to be consistent between the two.

Additionally, the desktop changelog can now be found at /changelog/desktop. I will put a redirect in place from the old location.

/sync-clients no longer exists. The information has been condensed down into the /install page. Again I will put a redirect in place. You can link to /install#desktop,#mobile and #server to scroll to the correct sections.

None of this is set in stone 100% because we haven't launched yet so shout out if any of the above is going to cause problems.

Contribook author avatars missing

Is there a way in CSS we can add like a placeholder image that will show if one of the author avatars is not found? I was thinking of showing it behind, but then I guess you would see the broken image icon on top. Maybe a js tweak?

@MariekevC @jancborchardt ?

http://owncloud.org/features/ lists OC5 features

Hi,

http://owncloud.org/features/ lists the old OC5 features. The link should be changed to http://owncloud.org/six/ to provide the current features of OC6.