[Owncloud] App settings

[Thomas Tanghus]

On Sunday 22 July 2012 22:01 Thomas Tanghus wrote:
> For quite some time there has been talk about moving personal settings away
> from settings/personal.php and have them at app level instead.

I have now made a simple popup for app specific settings based on Jans suggestions.

It requires very few changes for app maintainers:

- A button/link with the standard cog settings icon e.g:

   <a class="settings" title="<?php echo $l->t('Settings'); ?>">
      <img class="svg" src="core/img/actions/settings.svg" alt="<?php echo $l->t('Settings'); ?>" />
   </a>

- An element preferably somewhere inside #rightcontent looking either like:

   <div id="appsettings" class="popup topright hidden"></div>

 or like this:

   <div id="appsettings" class="popup bottomleft hidden"></div>

 depending on where you have your settings button.

- A call to popup the settings dialog e.g:

   $('#bottomcontrols .settings').on('click keydown', function() {
      OC.appSettings('appid'); // appid being 'contacts', 'calendar' etc.
   });

- Change one line in the settings script from:

	return $tmpl->fetchPage();

 to:

	$tmpl->printPage();

- And of course loading any js used in the settings. I suggest using the
namespace OC.AppName.Settings to keep a uniform naming scheme.

One small catch: I presume that the app use a script 'settings.php' in the 
root of the apps folder hierarchy. We could also use what is already available
from OCP\App::registerPersonal(), but then again some apps that don't have a
WUI and will have to use that space.

The mandatory screen shots:

http://owncloud.tanghus.net/public.php?service=files&token=b5010160a998edafc83c4eb7f56dd97d43473f83&file=/Pictures/Screenies/ownCloud/setting_popup_topright.png
http://owncloud.tanghus.net/public.php?service=files&token=83a0a9d1ad9a1725c6562288549ac1bf514df2d3&file=/Pictures/Screenies/ownCloud/setting_popup_bottomleft.png

Suggestions are for changes/improvements are welcome :-)

-- 
Med venlig hilsen / Best Regards

Thomas Tanghus