StencylSimple Share via e-mail, Twitter, Facebook etc. Extension (Openfl)

Note: This is a branch of SimpleShare with some bug fixes and minor changes to build with recent builds of OpenFL.

For Stencyl 3.4 and above

Stencyl extension for “Simple Share” on iOS and Android. This extension allows you to easily integrate Simple Share via e-mail, Twitter, Facebook etc. on your Stencyl game / application. (http://www.stencyl.com)

You can share a message with a website and with an image, via all existing apps on a mobile device. This extension use the IMAGE API to share an image.

KNOW ISSUES

Facebook
The website or image will share with Facebook and not the message.
It seems that a recent update to the Facebook application has replaced the in-built Facebook share activity with one that ignores status text .

Facebook's policies don't allow you to pre-populate status messages and require all content to be user generated - while I understand the intention behind this, I personally think it is kind of stupid in many cases - For example in my game I want to pre-populate the user's score, but now I can't, so the user is presented with an empty dialog box. I will probably simply remove the Facebook sharing option as no-one will ever use it now.
https://developers.facebook.com/docs/apps/review/prefill

WhatsApp ios Only
You can only share a image without a message, if you share a message with a image only the message will share with WhatsApp and not the image.

Important!!

This Extension Required the Toolset Extension Manager https://byrobingames.github.io

Main Features

Simple share with 1 button click.
Share Screenshot on IOS and Android
Return true or false (android always return true)
64-bit support to iOS
Tested with iPhone 5 IOS 8, Ipad IOS 8 and Samgsung Note 3 4.4.2

How to Install

To install this Engine Extension, go to the toolset (byRobin Extension Mananger) in the Extension menu of your game inside Stencyl.

Select the Extension from the menu and click on "Download"

If you not have byRobin Extension Mananger installed, install this first.
Go to: https://byrobingames.github.io

Screenshots

Documentation and Blocks Example

Just put the block under a share button, fill in a message with a website url and set yes or no if you wanna share a screenshot. Website has to start with http:// Select yes or no if you wanna share a screenshot.

Share Message with website

Send a message with website url to other app like facebook/twitter/email

Inputs

Message(as Text)
Website(as Text) start with http://

Share Message with website and with image

Send a message with website url and with an image to other app like facebook/twitter/email

Inputs

Message(as Text)
Website(as Text) start with http://
With image

If you want to share an image, use the build-in Image API blocks like “current sceen as image” for screenshot or “image from Actor” for an image of an Actor.
You als can share an personal image of your choose, just use the “Image from file” block

Callback If Share Message succeed or failed you can check if share succeed or failed.
On Android it will always return true even when share is failed.

Version History

2015-02-13 (1.0) : first release
2015-02-25 (1.1) : update Share with screenshot on IOS
2015-03-02 (1.2) : update Share with screenshot on Android
2015-03-07 (1.3) : update Return true of false if share succeed of failed. (On Android always return true even if share failed).
2015-03-12 (1.4) : FIX: share screenshot in landscape in IOS, IOS now also use the IMAGE API to take a screenshot.
2015-03-22 (1.5) : FIX: game crashed on iPad when share with screenshot, is fixed now.
2015-05-16 (1.6) : Android: Save screenshot to phone storage
2015-06-13 (1.7) Update info.txt file.
2015-07-31 (1.8) Add icon on blocks
2016-04-09(1.9.0) You can now share image by using the build-in IMAGE API blocks. Created an extra block.
2016-09-29(1.9.1) Added extra permission for iOS 10, so app will not crash, extension requires byRobin Extension Manager
2017-03-19(1.9.2) Added Android Gradle support for openfl4
2017-05-16(1.9.3) Tested for Stencyl 3.5, Required byRobin Toolset Extension Manager
2017-05-18(1.9.4) Fix: Crash on some iOS devices
2017-06-03(1.9.5) Fix: Crash on iOS when use with Unityads
2018-12-27(1.9.6) Fix crash on Android api 24>, Fix use with Stencyl 3.5

Submitting a Pull Request

This software is opensource.
If you want to contribute you can make a pull request

Repository: https://github.com/byrobingames/simpleshare

Need help with a pull request?
https://help.github.com/articles/creating-a-pull-request/

ANY ISSUES?

Add the issue on GitHub
Repository: https://github.com/byrobingames/simpleshare/issues

Need help with creating a issue?
https://help.github.com/articles/creating-an-issue/

Donate

License

Author: Robin Schaafsma

The MIT License (MIT)

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Tw1ddle/simpleshare