SBS Widget Pack - Plugin

    Summary

    The SBS Widget Pack plugin is a parent plugin for random helpful Widgets.  It is very similar to the Essential Plugin 4.0.x however, this plugin wil be geared to allow the control/configuration of Widgets and their use across the system.

     

    Official plugin of Plugins by ryanrutan

     

    Requirements

    Jive SBS 4.5.x - SBS Widget Pack Plugin 1.0.x

    Jive SBS 5.0.x - SBS Widget Pack Plugin 1.1.x

     

    Installation

    Plugin install through Admin Console, with optional configurations in the Admin Console under System > Settings > Configure Widget Pack.  In addition, Change Log and README files are available at <YOUR_SBS_URL>/plugins/sbs-widget-pack-plugin/changelog.html AND <YOUR_SBS_URL>/plugins/sbs-widget-pack-plugin/readme.html respectively.

     

    Configurations

    See the Configuration Screen located in the Admin Console:  System > Settings > Configure Widget Pack

    For the users who want to configure some of the specific behaviors, the following properties are available for Administrators.

    You may find the Admin Essentials Plugin helpful in setting Container specific properties.

     

    Plugin Support

    This plugin IS NOT supported by Jive, and use of this plugin should be done at the user's discretion, or as advised by their Jive Support representative.


    Copyright and License

    Copyright 2012 Ryan Rutan 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 athttp://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

    Special Thanks

    • Sid Lee
      Sid Lee is a company that develops brand experiences by creating products, services and spaces, and markets them through advertising, experiential marketing, branded content and interactive communications. To embed brands, products, spaces and services with more meaning and more resonance, we have assembled one of the most diverse creative teams in the world. Professionals from a vast array of disciplines:architecture, advertising, digital marketing, design, content, etc. work without barriers between the numerous crafts. Commercial creativity is how we describe this novel approach, which is both integrated and multi-disciplinary.  Our 400 artisans work globally for top-tier clients from our Montreal, Amsterdam, Paris and Toronto ateliers. 

      Sid Lee received the title of Agency of the year 2010, awarded by Marketing Magazine.


    • National Instruments

      National Instruments Corporation is a supplier of measurement and automation products that engineers and scientists use in a range of industries. These industries comprise a large and diverse market for design, control and test applications. The Company provides flexible application software and modular, multi-function hardware that users combine with computers, networks and third-party devices to create measurement, automation and embedded systems, which the Company also refers to as virtual instruments.

     

    Features

     

    Content Summary Widget (since 1.0.0)

    The Content Summary Widget is used to create a simple slice/dice interface on Container dashboard.  Notably, the Widget allows the Users to create CSS styles and Previews UIs by leveraging content tagging and standard HTML regions.

     

    Some of the more notable features:

    • Widget Enabled/Disabled Configuration (System Admin)
    • Widget Edit-Time Configuration (Container Admin)
      • Custom Widget Title (String)
      • Custom Inline CSS Definition (String [CSS Code], i.e. ".content-summary-state-bad {}" ... )
      • Tag Selector - Defines the Tag used to identify the master set of content to display (String [tag name], i.e. "product")
      • Tag Filters - Defines the additional filters used to provide a filtering interface (String [comma-delimited tag names], i.e. "good,bad,ugly")
        • Combines with Custom Inline CSS (see above) to provide style representations per Filter
      • Number of Results - Defines the max number of result to display in the Widget (Number, i.e. 10)
      • Allow Rich Comments - When enabled, the raw HTML (i.e. bolding, hyperlinks, etc...) is used for the Comment.  When disabled, only parsed text is used. (since 1.0.1)
      • Widget Run-Time Features
        • Text-Based Sub-Search
        • Tag Filter Sub-Search
        • Sort By Subject (ASC + DESC) and Last Modified (ASC + DESC)
        • Title link directly to Document
        • Comment - Pulled dynamically from 1st found <pre> block in document body content, suggested use of the Quote block highlighting.

       

      Screenshot(s):

      Screen shot 2011-02-08 at 4.47.01 PM.png

       

      Categorized Projects Widget (since 1.0.1)

      The Categorized Projects Widget is meant to provide an interactive alternative to the OOTB Projects Widget in SBS for.  The widget allows container admins to create arbitrary "Labels" on a per container basis (not to be confused with content categories from Jive) and then group projects under those Labels. For Spaces and Social Groups ONLY

       

      Some of the more notable features:

      • Widget Enabled/Disabled Configuration (System Admin)
      • Widget Edit-Time Configuration (Container Admin)
        • Custom Title
        • Default Category - Used to determine which sub-set is displayed onLoad.  Leave blank to show all (default)
        • Show Archived Projects - (Yes/No default)
        • Sort by Last Modified - (Yes / No default) otherwise, sort by Project Name
        • Number of Results - (Number, default 10)
        • Choose Source Container for Projects Displayed (default is Current Container, standard container selection control)
      • Widget Run-Time Features (see below)
        • Free-Text Search for Projects (added in 1.0.4.1)
        • Result Pagination (added in 1.0.4.1)
        • Sort by: Modification Date, Creation Date, and Alphabetically (added in 1.0.4.1)
        • Show Archived Projects - (Yes/No, only when enabled during Edit-Time Configuration) (added in 1.0.4.1)
        • Project Status Filter - (Complete / On Track / At Risk / Critical)
        • Category Filter - (All Projects + Container Admin defined categories)
        • Shows Project Header Information - Name, Status, Target Date, and Status Message
      • Container Admin Configuration Action (see below)
        • Manage Container Categories
        • Assign Category to Projects

       

      Screenshot(s):

      Screen shot 2011-05-10 at 9.38.22 AM.png

      Screen shot 2011-02-11 at 4.45.10 PM.png

      Upcoming Tasks Widget (since 1.0.2)

      This widget displays an aggregate of all Active Projects Incomplete Tasks.


      Some of the more notable features:

      • Widget Enabled/Disabled Configuration (System Admin)
      • Widget Edit-Time Configuration (Container Admin)
        • Custom Widget Title (String)
        • Number of Days - The number of days to look forward
        • Choose Layout:  Standard List or Group By Date
        • Choose Source Container for Tasks Displayed (default is Current Container, standard container selection control)
      • Widget Run-Time Features
        • Display Task Information
          • Title, Owner, and Due Date
          • Toggle Display for Task Notes
        • Displays Tasks by Due Date (Ascending)
          • Overdue Tasks are styled to indicate their overdue status
        • Unassigned Tasks are styled to indicate that they do not have an owner
          • Action to Take/Claim Task provided in-context

       

      Screenshot(s):

      Screen shot 2011-05-10 at 9.44.20 AM.png

      Screen shot 2011-05-10 at 9.44.29 AM.png

       

      Featured Places Widget (since 1.1.1.0)

      This widget displays a list of related Places (Projects, Groups, Spaces).  This list is defined by the Admin during the Edit Widget experience.  If a viewer does NOT have permissions to see a Place defined in this Widget, it will be hidden!

      Please see SBS Widget Pack - Feature Roadmap for more of the features.

       

      Note:  In its current state, the UI is very raw for the Admin.  I have intentions of making a nicer UI; however, needed the functionality sooner than later. 

      For those familiar with the Austen Rustrum's Related Groups Widget, it is very similar to that from what I've been told.

       

      Screenshot(s):

       

      Featured User Widget (since 1.1.1.0)

      This widget allows an Admin to feature an individual user on a dashboard along with a message.  Very simple, but it's better than no recognition at all.

      Please see SBS Widget Pack - Feature Roadmap for more of the features.

       

      Note: In its current state, the UI is very minimal.  Looking to get user feedback on what makes sense to add here and make it nicer.  For now it is what it is, and not much more. =)

       

      Screenshot(s):  Following added in 1.1.4.0

       

      Featured Ad Widget (since 1.1.2.0)

      This widget allows a System Admin to setup HTML ads in the Admin Console, and drop widgets through out the community to reference the ads.

      In addition, to static ads, it also supports a simple random sampling for ad rotation.

      All ads are centrally managed, being disabled or changed  from the Admin Console, at which point the widgets are updated/hidden automatically system-wide.

       

      Note: In its current state, the Admin UI is just System Property management.  I plan to make a nicer Admin UI, but for now...going for pure functionality.  Instructions included in the plugin readme.

       

      Twitter.com Widget Wrappers (since 1.1.3.0)

      The following widgets have been wrapped and made available in the Widget Menu on all container dashboards (Space, Social Group, and Projects), as well as the Home Page:

      The reason for wrapping these widgets, is such that they will not interfere with the Edit-Time Widget Interface when doing real-time polling updates.


      Known Issues

      • CategorizedProjectsWidget
        • Pagination when searching doesn't consolidate to a single page.  For example, pre-search if there were 3 pages of results.  Post-search there will be 3 pages of results.
          • Response:  With the ability to tag projects in Jive 5, need to re-write this implementation to take advantage and ditch the Categories extended property implementation.  This should fix this issue, but it is not a quick fix. (11/8/2011 - RR)