Social Media Buttons Website Plugin v1.8 (RMMV)

Social Media Buttons Website Plugin v1.8 (RMMV)

The Social Media Buttons Plugin enables you to display social media buttons (Twitter, Facebook, Google+, YouTube, Pinterest, and your project Website) on the Title Screen, each of which opens the corresponding website in a new window.

You can also use the plugin to send players to a website in-game via events with a simple Plugin Command.

 
Social Media Buttons/In-Game Website PluginPlugin RequirementsUsage InstructionsCompatibility IssuesPlugin CommandsVideo TutorialDownloadUpdate LogFuture UpdatesPersonal NotesTerms of Use
Version: 1.8
Author: Companion Wulf
Platform: RMMV
Script Type: Plugin
Required: None
Filesize: 24 Kb
File Format: JS/ZIP
Release Dates:
  • 1.8: 19 May 2020
  • 1.7: 01 May 2018
  • 1.6: 18 August 2017
  • 1.5: 28 August 2016
  • 1.4: 5 August 2016
  • 1.3: 20 July 2016
  • 1.2: 10 April 2016
  • 1.1: 7 April 2016
  • 1.0 (Beta): 3 April 2016
The plugin must be installed in RMMV’s Plugin Manager to run.

The plugin is written with RMMV Version 1.6+ in mind, but it might still work in older versions from 1.3 onwards.

The Social Media Buttons plugin only has five buttons to display: Twitter, Facebook, YouTube, Pinterest, and Website.

Each one can be toggled on or off and will display dynamically centered on the bottom of the Title Screen. When a button is disabled (toggled OFF in the settings), the buttons will reposition accordingly.

NOTE: If playing in a browser, the URL might not open if you have a popup blocker, so make sure you allow it. In Windows versions, a new window will open to display the website.

SETTINGS

These are the basic settings for each button. For a more comprehensive explanation of each, you can view the Social Media Buttons Help file provided in the ZIP.

TWITTER

These are the settings for sharing Twitter accounts via your games.

Twitter Toggle
This setting turns the Twitter button ON or OFF.

Twitter Action
Action is the behaviour type of the Twitter button. You can use one of three options: Screen Name, User ID or Follow.

  • Screen Name – The user name of the Twitter account you’d like your players to visit.
  • User ID – The unique identifier of the Twitter account.
  • Follow – Enables players to follow your Twitter account directly from within RPG Maker MV, whether in a window or browser. As long as the "Twitter Action Settings" is set correctly, this will automatically use the Screen Name or User ID.

Twitter Account
This sets the Username or User ID for the Twitter account you wish to use. It’s used in conjunction with the "Twitter Action" setting.

FACEBOOK

These are the settings for sharing a Facebook page from within RMMV.

Facebook Toggle
Show (ON) or hide (OFF) the Facebook button on-screen.

Facebook Page Name
This is the page name reference to display your Facebook page.

YOUTUBE

These options are to display sharing something from YouTbue.

Show YouTube
Show (ON) or hide (OFF) the YouTube button on the Title Screen.

YouTube Action
This is the behaviour type for the YouTube button. The options you can have are: User, Channel, Video or Playlist.

YouTube Account
This provides the information for the "YouTube Action". You don’t need the full URL, just the identifying information.

  • Username – The username you use for your main profile.
  • Channel ID – The ID reference of your video channel.
  • Video ID – The ID for the video you want to play in RPG Maker MV.

PINTEREST

These are the settings for sharing Pinterest account via your games.

Pinterest Toggle
Show (ON) or hide (OFF) the Pinterest button on the Title Screen.

Pinterest Username
This is the username you want to use. This will take visitors to your default profile page containing all your pins and boards.

Pinterest Board Name
If you want to share a specific board, then put the name of that board from the last part of its URL. Make sure you also put your username in the Pinterest Username parameter for it to work properly.

Leave this blank if you just want to display your normal profile.

NOTE: Visitors will most likely need to log in with Pinterest if "Window" is selected as the Display Method.

WEBSITE

These options set the website address you’d like visitors to go to when they click the button.

Website Toggle
Turns the Website icon ON or OFF.

Website URL
This is for setting your full website address. When the button is clicked, it’ll open in a window or browser.

DISPLAY METHOD

This selects how to display the "Website URL". You can choose to display your link in a game Window or in your default Browser.

ICONS

These are the icons you want to use for your social media buttons, separated by commas (Twitter, Facebook and Website).

Recommended size is 32×32.

Save these in the Pictures folder. If you use your own icons, be sure to change the settings to the filenames you used.

There shouldn’t be compatibility issues.

There has, however, been a report of conflicts (notably with some of Yanfly’s plugins), but I haven’t been able to replicate any errors.

Conflicts may occur with Yanfly’s External Links Plugin. The Social Media Buttons uses a separate internal URL parser, so there really shouldn’t be any conflicts.

The Social Media Buttons plugin has no additional Plugin Commands.

NOTE: It used to contain a showurl url command, but that was removed and is now integrated into the QEngine plugin (coming soon).

I created a video tutorial on how to use the Social Media Buttons plugin for those who need it.

¶ This video is now out-of-date and does not include Pinterest, which was added in Version 1.7. An updated video (and tutorial) will be uploaded soon.

Download the ZIP file and extract CW_SocialMediaButtons.js directly into the JS folder in your RMMV project. Be sure to read the Terms of Use file as well.
Be sure to read the Terms of Use for Scripts/Plugins as well.
For an up-to-date version history log, you can view it in the JS file from within the downloaded ZIP file.
  • Dynamic popup blocker alerter
  • Allow manual positioning of button block (to top left, top right, etc.)
  • Add mouse-over effects for icons??

Because Google+ shut down in March/April 2019, all references to Google+ were removed in the updated version.

Note: After v2.0, I’ll no longer actively update the plugin due to the way that most social media sites use their APIs and SDKs. While it IS possible to share an in-game screenshot and content from within MV, it’s not as easy as it may sound.

This isn’t necessarily from a developer’s perspective, but from the end-user perspective. I don’t want to over-complicate things, so will be keeping it simple and "as is": Promote and share your site on some of the most popular social media sites. And that’s it!

This was inspired by Yanfly’s excellent External Links plugin and something RPG Maker Web said once on Twitter. I integrated it into Adventures of Tryggr, then into Otherworld, but wrote my own to trim out some of the superfluous code and make it more compatible with Otherworld‘s menu.

So based on that same principle, I decided to add a separate block on the Title Screen to contain Otherworld‘s Twitter account and official blogsite, as well as RPG Maker Times Facebook page, rather than putting them in the main menu – to declutter it. I then adapted it for more general use.

This plugin is free to use under CC BY-NC 4.0, but please refer to the RPG Maker Times Terms of Use for other details, including for commercial use.

Credit "Companion Wulf" or "RPG Maker Times" if using this plugin in your projects.