Welcome, guest | Sign In | My Account | Store | Cart

Notice! PyPM is being replaced with the ActiveState Platform, which enhances PyPM’s build and deploy capabilities. Create your free Platform account to download ActivePython or customize Python with the packages you require and get automatic updates.

Download
ActivePython
INSTALL>
pypm install hexagonit.socialbutton

How to install hexagonit.socialbutton

  1. Download and install ActivePython
  2. Open Command Prompt
  3. Type pypm install hexagonit.socialbutton
 Python 2.7Python 3.2Python 3.3
Windows (32-bit)
Windows (64-bit)
Mac OS X (10.5+)
Linux (32-bit)
0.8.1
0.9Never BuiltWhy not?
0.8.1 Available View build log
0.8 Available View build log
Linux (64-bit)
0.9 Available View build log
0.8.1 Available View build log
0.8 Available View build log
 
Author
License
BSD
Lastest release
version 0.9 on Jan 9th, 2014

This package provides viewlet to embed social button to Plone site. The viewlet can be assigned to wherever viewlet managers through the web. Since restrictions for the embedded code are not set, you need to be cautious about the security risk with the embedding code.

Configuration

Once the package is installed through Site Setup Add-ons, there appears Social Button Code Setting and Social Button Configuration links within the Add-on Configuration section.

To start the configuration, go to Social Button Code Setting first to set the embedding code.

Social Button Code Setting
ID
The ID will be used for farther configuration and styling.
Code
The code to be embedded to viewlet.

Example to set values from file system code:

registry = getUtility(IRegistry)
registry['hexagonit.socialbutton.codes'] = {
    u'facebook': {
        u'code_text': u'<FACEBOOK>${title} <img src="${portal_url}/++resource++hexagonit.socialbutton/facebook.gif" /></FACEBOOK>',
    }
}

Example to register through registry.xml:

<record name="hexagonit.socialbutton.codes">
  <field type="plone.registry.field.Dict">
    <title>Codes for Social Buttons</title>
    <key_type type="plone.registry.field.TextLine" />
    <value_type type="plone.registry.field.Dict">
      <title>Value list</title>
      <key_type type="plone.registry.field.TextLine" />
      <value_type type="plone.registry.field.Text">
        <title>Values</title>
      </value_type>
    </value_type>
  </field>
  <value>
    <element key="facebook">
      <element key="code_text">&lt;FACEBOOK&gt;${title} &lt;img src="${portal_url}/++resource++hexagonit.socialbutton/facebook.gif" /&gt;&lt;/FACEBOOK&gt;s</element>
    </element>
  </value>
</record>
Code variables
${title}
Title of the context.
${description}
Description of the context.
${url}
URL for the context
${lang}
Language in use like en.
${lang_country}
Locales including country code such as en_US.
${portal_url}
Plone site root URL.

Once Social Button Code Setting is set, you can go to Social Button Configuration for the farther configuration.

Social Button Configuration
ID
The ID set at Social Button Code Setting.
Content Types
The content types where the viewlet will be applied.
Viewlet Manager
Add the names of viewlet managers line by line where the viewlet will be applied.
View Models
Add the names of views where the viewlet will be applied. For all the views, use *.
View permission only
If checked, the viewlet is only available at view which are available to anonymous users, like in most cases for published contents.
Enabled
Uncheck this option, when disabling the code from the viewlet.

Example to set values from file system code:

registry = getUtility(IRegistry)
registry['hexagonit.socialbutton.config'] = {
    u'facebook': {
        u'content_types': u'Page,News Item',
        u'viewlet_manager': u'plone.abovecontent\nplone.belowcontent',
        u'view_models': u'*',
        u'view_permission_only': 'True',
        u'enabled': 'True',
    }
}

Example to register through registry.xml:

  <record name="hexagonit.socialbutton.config">
    <field type="plone.registry.field.Dict">
      <title>Configuration for Social Buttons</title>
      <key_type type="plone.registry.field.TextLine" />
      <value_type type="plone.registry.field.Dict">
        <title>Value list</title>
        <key_type type="plone.registry.field.TextLine" />
        <value_type type="plone.registry.field.Text">
          <title>Values</title>
        </value_type>
      </value_type>
    </field>
    <value>
      <element key="facebook">
        <element key="content_types">Page,News Item</element>
        <element key="viewlet_manager">plone.abovecontent
plone.belowcontent</element>
        <element key="view_models">*</element>
        <element key="view_permission_only">True</element>
        <element key="enabled">True</element>
      </element>
    </value>
  </record>

Change log

0.9 (2012-11-13)
  • Added permission: hexagonit.socialbutton: Manage Social Button to manage social button. [taito]
0.8.1 (2012-09-28)
  • Fixed bug for multiple line code. [rnd, taito]
0.8 (2012-09-20)
  • Added dependency to Plone>=4.2.1 and removed dependency to plone.stringinterp>=1.0.7 since Plone-4.2.1 includes it. [taito]
0.7 (2012-08-22)
  • Dependency to plone.stringinterp>=1.0.7 added to make string interpolation available in the context of Plone Site root. [taito]
0.6 (2012-08-21)
  • Added guards for cases of None to the upgrade step [rnd]
0.5 (2012-08-17)
  • Updated registry.xml to enable import and export. [taito]
  • Switched to use plone.stringinterp instead of format method for string interpolation in embedding codes. [taito]
0.4 (2012-08-13)
  • Fixing typo. Po-files initialized. Some translations. [rnd]
  • Fixing the problem with some views: guarding the viewlet [rnd]
  • google-plus image added [taito]
0.3 (2012-08-08)
  • Added class for styling against viewlet managers. [rnd]
0.2 (2012-08-02)
  • Uninstall profile to remove registry records added. [taito]
  • UnicodeDecodeError for context title and description fixed for the viewlet. [taito]
  • Added 'Plone Site' to the configurable content types. [taito]
0.1 (2012-07-31)
  • Initial release for use. [taito]
0.0 (2012-07-24)
  • Initial release. [taito]

Contributors

  • Kai Lautaportti <kai.lautaportti at hexagonit.fi>
  • Roman Susi <roman.susi at hexagonit.fi>
  • Taito Horiuchi <taito.horiuchi at hexagonit.fi>

Subscribe to package updates

Last updated Jan 9th, 2014

Download Stats

Last month:1

What does the lock icon mean?

Builds marked with a lock icon are only available via PyPM to users with a current ActivePython Business Edition subscription.

Need custom builds or support?

ActivePython Enterprise Edition guarantees priority access to technical support, indemnification, expert consulting and quality-assured language builds.

Plan on re-distributing ActivePython?

Get re-distribution rights and eliminate legal risks with ActivePython OEM Edition.