Requirements
Joomla! 6 Joomla! 5 Joomla! 4 (EOL - Not supported) Joomla! 3 (EOL - Not supported) PHP 8.1+
- Basic Joomla! knowledge available between the chair and the keyboard :)
Installation is easy!
- Download the plugin
- in the Back-end go to menu Extensions > Manage
- in the tab [Upload file package] click [browse] and select your downloaded plugin
- click [Upload & Install], wait for the installation to finish
Configuration
- in the back-end go to menu Extensions > Plugins
- search / locate the 'ochSocials' content plugin
- open the plugin
- in the tab [Plugin] set status to [Enabled] and click [Save], an additonal tab 'Core Joomla' will now display.
- in the tab [ochSocials buttons] configure your buttons > click [Toggle Inline Help] to get instruction for configuration field
- in the tab [ Platform Settings] configure platform specific settings (for the platforms you enabled)
- in the tab [ochSocials Theme] configure the theme that you want to use
- In the tab [Custom campaigns] configure your UTM parameter (e.g. used for tracking Campaigns in Google Analytics)
- in the tab [Core Joomla] configure the automatic insertion of the buttons on selected categories (top, bottom, readmore position) or views
- click [Save & Close] and you are good to go
Activate Joomla! One Click update and change-log integration
When you install the extension, it will automatically integrate with the Joomla Updater for both updates and change-logs.
On first use, the Joomla updater will prompt you with a 'Download Key is missing!' message.
- On this site: Go to [Tools > My Account > My Download Keys], and copy your Download ID#.
- On your site: Go to System > Update Sites, locate the extension, and paste the Download ID into the 'Download Key' field. Click [Save and Close].
Important:
If you're using this Download ID on a new server, you’ll receive an email to approve the device. Click the link in the email to enable downloads from this server.
Without approval, updates won’t be authorized, and the Joomla updater will display a 401 Unauthorized error when trying to fetch updates.
That’s it! You're all set.
New
- Print button: a native print button can now be added alongside your social sharing buttons. No configuration beyond enabling it.
- Clap button: this button lets people show their appreciation without sharing anything anywhere, it's just an "applause" on the page it's on. You'll notice the clap count is not added to the share total count, so that total stays focused on shares only. No configuration beyond enabling it.
- Share counts and threshold control: Total share counts can now be displayed and toggled in the configuration. A new threshold setting lets you hide counts below a number you define, so you are not showing a low count on a fresh article.
- Share count throttling: Share count updates are now throttled to one update per platform per URL per minute by default. This prevents abusers from targeting the share count to increase it. It can be turned off in the advanced configuration if needed.
- CustomEvent on share click: ochSocials now fires a CustomEvent (JavaScript) on every share click, making it straightforward to hook into your analytics or monitoring tools without any workarounds.
- Refactored confirmation messages: the confirmation message (e.g. copy button) now displays the same way any other message on your site does (Joomla Core message), consistent with your template and without any risk of conflicts.
- Share / Clap counter immediately updates when clicked: when you click a button, direct visual feedback is given. Previously, the counter only updated on page refresh, or on cache refresh, if caching was configured.
Manually add Social sharing buttons in your blog / article
You can place the buttons automatically on the top or bottom (or both) positions of the selected article categories, but the real power lies in the manual placement of the Social sharing buttons:
- open the blog / article (or even HTML module!) that you want to place the Social sharing buttons in
- insert:
- {ochsocials} into the location where you want to automagically display the Social sharing buttons, or
- {ochsocials url="https://your custom url", title="your custom text", buttonorder="F,X"} into the location where you want to automagically display the Social sharing buttons
- click [Save & Close]
- when surfing to your article / blog on the frontend, the Social sharing buttons should automagically show up: Cool :)
All buttons on device DesktopMobile listed below:
Overview of tag parameters
You can set or override the configured plugin settings with the following parameters. Want to remove a configured setting? Just add the parameter with empty string (like: via=""):
- url="htps://your custom url"
- title="your custom title"
- buttonorder="your buttons in the order you like"
- via="X (twitter) via accountname"
- call2action="X (twitter) added text"
- hashtags="X (twitter) added hashtags"
- quote="your Facebook quote text"
- image="your Pinterest image"
- author="@mastodon author name"
- mashtags="#mastodon hashtags"
Support for Custom Article Fields
You can set or override the configured plugin settings with the following Custom Article Fields, you need to first create these Custom Article Fields and then map them to ochJSsocials in the plugins Integration tab:
- url (field type url)
- title (field type: text)
- buttonorder (field type text)
Agency Bundle - 12 months
ochSocials - 12 months
Tips & Tricks
- ochSocials replaces both jssocials tag and ochsocials tag
- Did you know that the Pinterest button only shows when you have an (intro) image in your blog / article?
- Did you know that in order for the plugin to work on a 'Custom HTML' module, you need to configure this module to 'Prepare content = yes' in the options tab?
Important: when using a Custom module to display the buttons and you display that module on multiple pages: remember to disable caching of the module in the modules advanced settings!
- Do you prefer round buttons? > in back-end tab [ochSocial Buttons] disable 'Responsive Buttons', 'Show Button Labels' and 'Show Share Count' and in tab [ochSocials Theme] add the following custom css rule
- .ochsocials-share-link { border-radius: 50%; }
- Make sure you set in [ochSocials Buttons] tab:
- Responsive buttons = No
- Show button labels = No
- Show share count = No
- Display the Social Sharing buttons in Kunena (6.x)? read here how to do that: Social Sharing buttons in Kunena (jssocials)
- When you entered the ochsocials tag in a Custom HTML module and it doesn't 'convert' into buttons: configure you custom HTML module with 'Prepare Content'=yes (Options tab)
We do our best to give you the best possible user experience. We are committed to give you the best support possible.
Joomla! 6 Joomla! 5 Joomla! 4 (EOL - Not supported) Joomla! 3 (EOL - Not supported) PHP 8.1+
| Security updates | Free Available to all licence holders within the support period, including expired subscriptions. Temporary download access (30 days) is activated for all license holders on the day of release. |
| Bug fixes & improvements | Active subscription Available to customers with an active subscription. |
| New features | Active subscription Available to customers with an active subscription. |
| End-of-life platforms | Not available Security updates are not backported to Joomla or PHP versions that have reached end of life. Customers on unsupported platforms are advised to upgrade. |
| EU Declaration of Conformity - ochSocials | |
| Manufacturer | OnlineCommunityHub, Netherlands |
| Product name | ochSocials |
| Supported series | 1.2.x (minor and patch releases included) |
| Product description | Joomla extension - regular product with digital elements |
| CRA product class | Regular product (CRA Annex III not applicable) |
| Conformity procedure | Self-assessment - Article 32(1), Regulation (EU) 2024/2847 |
| Supported platforms | Joomla! 6 Joomla! 5 Joomla! 4 (EOL - Not supported) Joomla! 3 (EOL - Not supported) PHP 8.1+ |
| Support period | Minimum 5 years from date of first purchase |
| Regulation Regulation | (EU) 2024/2847 of the European Parliament and of the Council |
Software Bill of Materials (SBOM)
Third-party libraries bundled with this extension. All versions have been verified against known vulnerability databases at the time of release.
| Library | Version |
|---|---|
| mobiledetect/mobiledetectlib | 4.11.0 |
| psr/simple-cache | 3.0.0 |
See our vulnerability disclosure policy or report directly via the contact form.