#15

Product support

Get help in the plugin support forum.

Categories

  • Marketing
  • Social

Changelog

1.1.9:

26/09/2017

  • Fixed for compatibility with Laravel 5.5 (PHP 7+, October 420+)
  • Add Exceptions on Facebook and Twitter behaviors
  • Fix Twitter publication with title and url
  • Fix getting image relation issue

1.1.8:

22/09/2011

  • Add Twitter
  • Add enable/disable switch in settings
  • Made minor generic improvements

1.1.7:

22/07/2017

  • Fix Media Manager issue
  • Update SemanticUI to 2.2.11
  • Remove unused css and js libs
  • Use data-request-flash attribute
  • Rewrite Publisher JS library

1.1.6:

21/02/2017

  • Fix issue with null param to Page::url
  • Fix error on first config Facebook api and secret key
  • Remove attribute data-request-loading that cause JS error

1.1.5:

23/10/2016

  • Remove fields and use publish_fields.yaml instead
  • Add events on extend fields and model
  • Made improvements in MercadoLibre plugin
  • Made improvements in Publisher formwidget

1.1.4:

29/09/2016

  • Completelly separate facebook driver
  • Move facebook partials to their own folder
  • Move partials from settings to each behavior
  • Add "dot" syntax to Settings::set
  • Add config widgets to be used
  • Add Events to be extended
  • Separate Facebook functions to their behavior
  • Css improvements
  • Implement widget behaviors to Settings model
  • Separate fields settings to each widget behavior
  • New WidgetBase Class to be used in widget behaviors

1.1.3:

25/09/2016

  • Add MercadoLibre

1.1.2:

13/09/2016

  • Use "dot" syntax in Settings model
  • UI improvements
  • Separate drivers, like Facebook

1.1.1:

12/09/2016

  • Fix sidebar problems

1.1.0:

05/09/2016

  • Update Copyright
  • Remove unused css/js files.

1.0.9:

03/09/2016

  • Rename widget partials to have PHP support on IDE
  • Change Material GUI to Semantic UI
  • Update Sammik Facebook library to ^3.0
  • Update Event listen to be loaded only if necessary
  • Improve plugins integration config.

1.0.8:

10/02/2016

  • Add PlanetaDelEste\Widgets dependency
  • Save token from diferent users
  • Fix problem with special chars
  • Add method to reload Facebook pages from settings

1.0.7:

10/02/2016

  • Register form widget FacebookBtn
  • Save user token
  • New methods Settings::getAccessToken and Settings::validateAccessToken
  • Publish panel history, show facebook publication url.

1.0.6:

16/01/2016

  • Add PostModel Behavior
  • Change model extend to implement new behavior

1.0.5:

03/12/2015

  • Add new filter to show published/unpublished records

1.0.4:

02/12/2015

  • Show published status in list controller

1.0.3:

02/12/2015

  • Use morph relationship

1.0.2:

24/09/2015

  • Fix a problem loading form fields.

1.0.1:

31/07/2015

  • First version of SocialPublish
  • create_posts_table.php

These plugin(s) are required for the plugin:

Plugin Settings

Install

Add this plugin to your projects using the marketplace or install directly using the code PlanetaDelEste.SocialPublish

Important

This plugin require the free plugin PlanetaDelEste.Widgets

Config

From the OC Backend, go to Settings > Social Publish.
The plugin read all the installed plugins and show the possible controller where can be integrate. There is no need to writing any code in the integrated plugins.

Config

Config.php

From config.php file is possible to exclude plugins on this integration panel.

return [
    'exclude_plugins' => [
        'PlanetaDelEste\Swal',
        'PlanetaDelEste\Features',
        'RainLab\Location',
        'RainLab\Translate',
        'RainLab\User',
        'RainLab\Pages',
    ],
    'widgets' => [
        'Facebook',
    ]
];

If you can write your own widget to integrate on Twitter, Google+, etc.; must be added to widgets section.
The widgets are located in /behaviors folders. From now, only Facebook widget is done, but I want to write Google+, Twitter and others in future.

Facebook settings

At first, click the Facebook login button, and use the Fb account you want to publish. Facebook Settings

After that, you can select to publish on your personal profile or in any of your administrated pages. Facebook Settings

Register and Configure an App to have App ID and Secret

1. Login to Facebook

Before creating a developer account, login in to your Facebook account.

2. Developer Account

You'll need Facebook developer account to get started. If you don't have one upgrade your personal Facebook account to a Facebook Developer account now. Skip this step, if you already have a developer account.

3. Create new Facebook app

Choose Apps in the header navigation and select Add a New App or click here.

4. Choose Platform

Choose the platform you want to add. If your app is on multiple platforms, you'll be able to add them to your Facebook app later.

Choose Platform

5. Choose a Name

Choose a name for your app and select Create New Facebook App ID. Choose a category for your app. If you're creating a test version of an existing Facebook app, select the app you're testing.

Choose a Name

6. Follow "Quick Start" Steps

The quick start wizard will help you to set up your Facebook app for the selected platform. You can come back to the quick start wizard at a later time to either continue your setup or add a new platform to your app.

Choose Platform

7. App ID

Your app will have a unique app ID. You will use this ID whenever you use one of our SDKs or Open Graph tags for sharing. You can find your app ID in your app's dashboard.

App ID


Twitter Settings

Create a new application

Fill the form at apps.twitter.com/app/new Create an application

After create your app, from application settings page, go to Keys and Access Tokens tab, copy the app Consumer Key (API Key), Consumer Secret (API Secret), Access Token and Access Token Secret

Keys and Access Tokens

Configure the plugin

From SocialPublish settings page, go to Twitter tab and paste Consumer Key (API Key), Consumer Secret (API Secret), Access Token and Access Token Secret inputs. Enable to publish must be ON

Twitter Settings


Using Social Publish

Settings on integrated plugin

Sidebar panel

Each integrated plugin must be configured with SocialPublish. This is needed only the first time Click the settings button Settings Button to open the sidebar.

Page to generate link

Select the page where the current plugin display the content (for Blog plugin, is where the blogPost component are used.

Slug

Select the form field for the url slug parameter.

Url address

Before select the Page and Slug, here you can se the url to visit the current post.

Title

Select the form field to used as title in the facebook publication

Description

Select the form field to used as description in the facebook publication

History

From here you can see how many times the current post (or plugin content) are published in Facebook.


Publish into Socials

After configuring the widget, is time to share. Publish You can publish on all enabled social networks, by choose Publish all or can select only one. After select the publish method, click the selected item.

After that, must confirm the action. Confirm

Important
Before click the publish button, the plugin content must be saved with images (if have)

Tip

In frontend page, use this metas for social share.
Source (https://css-tricks.com/essential-meta-tags-social-media/)

<!--  Essential META Tags -->

<meta property="og:title" content="European Travel Destinations">
<meta property="og:description" content="Offering tour packages for individuals or groups.">
<meta property="og:image" content="http://euro-travel-example.com/thumbnail.jpg">
<meta property="og:url" content="http://euro-travel-example.com/index.htm">
<meta name="twitter:card" content="summary_large_image">

<!--  Non-Essential, But Recommended -->

<meta property="og:site_name" content="European Travel, Inc.">
<meta name="twitter:image:alt" content="Alt text for image">

<!--  Non-Essential, But Required for Analytics -->

<meta property="fb:app_id" content="your_app_id" />
<meta name="twitter:site" content="@website-username">

Tested on

1.1.9

Fixed for compatibility with Laravel 5.5 (PHP 7+, October 420+)

Sep 26, 2017

1.1.8

Add Twitter

Sep 22, 2017

1.1.7

Fix Media Manager issue

Jul 22, 2017

1.1.6

Fix issue with null param to Page::url

Feb 21, 2017

1.1.5

Remove fields and use publish_fields.yaml instead

Jan 28, 2017

1.1.4

Completelly separate facebook driver

Jan 28, 2017

1.1.3

Add MercadoLibre

Jan 28, 2017

1.1.2

Use "dot" syntax in Settings model

Jan 28, 2017

1.1.1

Fix sidebar problems

Jan 28, 2017

1.1.0

Update Copyright

Jan 28, 2017

1.0.9

Rename widget partials to have PHP support on IDE

Jan 28, 2017

1.0.8

Add PlanetaDelEste\Widgets dependency

Jan 28, 2017

1.0.7

Register form widget FacebookBtn

Jan 28, 2017

1.0.6

Add PostModel Behavior

Jan 28, 2017

1.0.5

Add new filter to show published/unpublished records

Jan 28, 2017

1.0.4

Show published status in list controller

Jan 28, 2017

1.0.3

Use morph relationship

Jan 28, 2017

1.0.2

Fix a problem loading form fields.

Jan 28, 2017

1.0.1

First version of SocialPublish

Jan 28, 2017