Menu

#2400 Twitter plugin

Parent Category:
DPCalendar
Category:
Calendar plugins
Last Updated:
Allon Moritz, Tuesday, 02 May 2023 15:49
Created:
Monday, 20 April 2015 07:29
Hits:
4517

This feature is part of the DPCalendar Premium subscription.
SubscribePHP 7.4PHP 8Joomla 3.10Joomla 4.4Joomla 5

Introduction

The DPCalendar Twitter plugin allows to publish DPCalendar event updates to Twitter. It supports unlimited Twitter accounts.

You can also display your Twitter events in DPCalendar through the plugin. This feature has an experimental status as Twitter doesn't allow to fetch your tweets based on date/time criteria.

Meta tags

The Twitter plugin adds automatically to the event details and the list views the required meta tags for Twitter cards. More information about Twitter cards can be found here.

The plugin adds the following OG attributes to the head of the page:

  • twitter:title The title of the event or calendar
  • twitter:description The description of the event or calendar
  • twitter:url The current page
  • twitter:image The full image of the event or calendar
  • twitter:image:alt The full image alternative text of the event or calendar
  • twitter:site The calendar title without spaces
  • twitter:creator The calendar title without spaces

Twitter Developer account

Since the introduction of DSGVO and some other data leach incidents on the web, Twitter has restricted their access to the API. To be able to use their API, you need to create a developer account which must be verified. You will have then a free account with a low volume of requests available for free to use the API. If you need higher volumes with more data, then you need to pay for the data.

  1. Open developer.twitter.com/apps in your browser and login with your Twitter account.
  2. Click on "Apply" on the top right corner of the web site.
  3. Click on "Apply for a developer account".
  4. Click on "Building tools for Twitter users".
  5. Click on "Next" on the bottom of the page.
  6. Fill in the data and verify your phone if needed.
  7. Click on "Next" on the bottom of the page.
  8. Answer the questions.
  9. Click on "Verify".

Your account should then get verified automatically.

Add your Twitter account

In the following steps we tell you how to add your Twitter API key, API secret, Access token and Access Token Secret to your DPCalendar - Twitter plugin.

  1. Open developer.twitter.com/apps in your browser and login with your Twitter account.
  2. Click on "New App"
  3. Fill in the information as requested and accept the terms.
  4. Open your new app on developer.twitter.com/apps.
  5. Click New on Extensions -> Plugin _Manager -> DPCalendar - Twitter in your Joomla back end.
  6. Set the title and color on the calendar.
  7. Copy the Consumer API key, Consumer API Secret, Access token and Access token secret from your Twitter app into your new Twitter DPCalendar calendar.
  8. Select a DPCalendar calendar to publish the updates of it to Twitter.
  9. Save the calendar.
Twitter keys

Configuration and usage

After you have added your Twitter account, publish the plugin. When you edit now an event of the selected DPCalendar calendar, the update should be published on your Twitter account. You can define which actions should be published and if child calendars should be included in the publish actions.

If you want to modify the content of the published tweets you have to make language overrides of the following constants:

  • PLG_DPCALENDAR_TWITTER_STATUS_EVENT_CREATED
  • PLG_DPCALENDAR_TWITTER_STATUS_EVENT_UPDATED
  • PLG_DPCALENDAR_TWITTER_STATUS_EVENT_DELETED

How to make a language override can be found in the official Joomla documentation. Keep in mind that Twitter allows only content up to 280 characters!

Twitter actions

Tweets in the calendar (experimental)

You can select your Twitter account as an ordinary calendar in the DPCalendar menu links or modules. Please not as this feature has still an experimental status as the Twitter API doesn't support time based queries on the tweet stream.

DPCalendar Options

These settings are the same for every calendar configured in the plugin.

API Key [Type: Text]
Please login to your Twitter account and get the API key from https://apps.twitter.com/app.
API Secret [Type: Text]
Please login to your Twitter account and get the API secret from https://apps.twitter.com/app.
Access Token [Type: Text]
Please login to your Twitter account and get the access token from https://apps.twitter.com/app.
Acces Token Secret [Type: Text]
Please login to your Twitter account and get the access token secret from https://apps.twitter.com/app.
Calendars [Type: Dpcalendar]
Select the calendars to publish updates to Twitter.
Include Child Calendars [Type: Dpradio] [Default: No]
Should changes in child calendars published too?
The following options are available:
  1. Yes
  2. No
Publish Create Event [Type: Dpradio] [Default: Yes]
Should a new tweet be posted when a new event is created.
The following options are available:
  1. Yes
  2. No
Publish Update Event [Type: Dpradio] [Default: Yes]
Should a new tweet be posted when an event is updated.
The following options are available:
  1. Yes
  2. No
Publish Delete Event [Type: Dpradio] [Default: No]
Should a new tweet be posted when an event is deleted.
The following options are available:
  1. Yes
  2. No

Plugin Options

Caching [Type: List] [Default: Joomla]
Select whether to cache the calendar data.
The following options are available:
  1. Joomla
  2. Database
  3. Never
Cache Time [Type: Text] [Default: 900]
The time for the cache in sec.
Sync Start [Type: Text] [Default: -3 year]
The relative start date to sync from.
Sync End [Type: Text] [Default: +3 year]
The relative end date to sync from.
Sync Steps [Type: Text] [Default: 1 year]
The sync steps.

Comments (0)

We use cookies on our website. Some of them are essential for the operation of the site, while others help us to improve this site and the user experience (tracking cookies). You can decide for yourself whether you want to allow cookies or not. Please note that if you reject them, you may not be able to use all the functionalities of the site.

Ok Decline
More information