You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@rave.apache.org by ja...@apache.org on 2011/10/26 15:14:28 UTC
svn commit: r1189188 - in /incubator/rave/site/trunk/content/rave:
documentation/ images/
Author: jasha
Date: Wed Oct 26 13:14:28 2011
New Revision: 1189188
URL: http://svn.apache.org/viewvc?rev=1189188&view=rev
Log:
Document admin interface
Added:
incubator/rave/site/trunk/content/rave/documentation/admin-interface-users.mdtext
incubator/rave/site/trunk/content/rave/documentation/admin-interface-widgets.mdtext
incubator/rave/site/trunk/content/rave/documentation/admin-interface.mdtext
incubator/rave/site/trunk/content/rave/images/screenshot-admin-userdetails.png (with props)
incubator/rave/site/trunk/content/rave/images/screenshot-admin-widgetdetails.png (with props)
Added: incubator/rave/site/trunk/content/rave/documentation/admin-interface-users.mdtext
URL: http://svn.apache.org/viewvc/incubator/rave/site/trunk/content/rave/documentation/admin-interface-users.mdtext?rev=1189188&view=auto
==============================================================================
--- incubator/rave/site/trunk/content/rave/documentation/admin-interface-users.mdtext (added)
+++ incubator/rave/site/trunk/content/rave/documentation/admin-interface-users.mdtext Wed Oct 26 13:14:28 2011
@@ -0,0 +1,43 @@
+Title: Portal Admin interface: Users
+Notice: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+ .
+ http://www.apache.org/licenses/LICENSE-2.0
+ .
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+A portal administrator is able to manage account data of other users:
+
+ - Email address
+ - OpenId URL
+
+It is currently not possible to change the username or password of a user.
+
+To access the admin interface, see [Portal admin interface](admin-interface.html).
+
+## Account status
+
+A User is able to login if his account is `enabled`, not `expired` and not `locked`. These properties can be managed
+through the admin interface.
+
+Note: an admin cannot disable, expire or lock his own account through the admin interface
+
+## Authorities
+
+The following authorities are defined for the portal:
+
+ - `ROLE_USER`: a user with this role can view portal pages
+ - `ROLE_ADMIN`: a user with this role can view the portal pages and use the admin interface
+
+
+![Screenshot of user details in admin interface](/rave/images/screenshot-admin-userdetails.png)
Added: incubator/rave/site/trunk/content/rave/documentation/admin-interface-widgets.mdtext
URL: http://svn.apache.org/viewvc/incubator/rave/site/trunk/content/rave/documentation/admin-interface-widgets.mdtext?rev=1189188&view=auto
==============================================================================
--- incubator/rave/site/trunk/content/rave/documentation/admin-interface-widgets.mdtext (added)
+++ incubator/rave/site/trunk/content/rave/documentation/admin-interface-widgets.mdtext Wed Oct 26 13:14:28 2011
@@ -0,0 +1,43 @@
+Title: Portal Admin interface: Widgets
+Notice: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+ .
+ http://www.apache.org/licenses/LICENSE-2.0
+ .
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+Portal admins are able to update the stored metadata of widgets: URL of the actual widget, its availability in the portal, thumbnail etc.
+
+To access the admin interface, see [Portal admin interface](admin-interface.html).
+
+## Overview
+
+The list of widgets will be growing. In the admin interface it's possible to filter widgets on status (`preview`, `published`), type (`OpenSocial`, `W3C Widget`) or a free text search in the widget's title and description. All search criteria are optional.
+
+Only widgets that are marked as `published` will appear in the portal widget store. If a user adds a new widget, its status is set to `preview`
+
+## Widget metadata
+
+ - Title: the title that is used in the widget store
+ - Location: the URL for the widget definition
+ - Type: defines which widget provider should be used for rendering the widget
+ - Description: shown in the widget store
+ - Status: defines if the widget is available in the store (in the future it will be possible to block a gadget)
+ - Thumbnail: shown in the widget store listing
+ - Screenshot: gives the user an idea how the widget will look like. Shown on the widget detail page in the widget store.
+ - URL the gadget title links to: if filled in, the title of the rendered gadget will link to this URL
+ - Author: will be shown in the widget store
+ - Author email: can be used to contact the author, currently not shown in the widget store
+
+
+![Screenshot of Widget metadata](screenshot-admin-widgetdetails.png)
\ No newline at end of file
Added: incubator/rave/site/trunk/content/rave/documentation/admin-interface.mdtext
URL: http://svn.apache.org/viewvc/incubator/rave/site/trunk/content/rave/documentation/admin-interface.mdtext?rev=1189188&view=auto
==============================================================================
--- incubator/rave/site/trunk/content/rave/documentation/admin-interface.mdtext (added)
+++ incubator/rave/site/trunk/content/rave/documentation/admin-interface.mdtext Wed Oct 26 13:14:28 2011
@@ -0,0 +1,29 @@
+Title: Portal Admin interface
+Notice: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+ .
+ http://www.apache.org/licenses/LICENSE-2.0
+ .
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+The Rave Portal has an admin interface to manage data from [users][1] and [widgets][2] (version 0.5-INCUBATING).
+In the future it may also support manage group data, show portal usage statistics or change the look and feel of the portal.
+
+## Access the admin interface
+
+The address of the admin interface is [http://localhost:8080/portal/app/admin/].
+User `canonical` (password: `canonical`) is the only user with admin privileges. Other users will not be able to go to the admin interface.
+
+
+[1]: admin-interface-users.html
+[2]: admin-interface-widgets.html
\ No newline at end of file
Added: incubator/rave/site/trunk/content/rave/images/screenshot-admin-userdetails.png
URL: http://svn.apache.org/viewvc/incubator/rave/site/trunk/content/rave/images/screenshot-admin-userdetails.png?rev=1189188&view=auto
==============================================================================
Binary file - no diff available.
Propchange: incubator/rave/site/trunk/content/rave/images/screenshot-admin-userdetails.png
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Added: incubator/rave/site/trunk/content/rave/images/screenshot-admin-widgetdetails.png
URL: http://svn.apache.org/viewvc/incubator/rave/site/trunk/content/rave/images/screenshot-admin-widgetdetails.png?rev=1189188&view=auto
==============================================================================
Binary file - no diff available.
Propchange: incubator/rave/site/trunk/content/rave/images/screenshot-admin-widgetdetails.png
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream