Ryan,
First off, great to hear you're learning. Facebook integration is incredibly in-depth, and we hope we've made it at least approachable. Before I go off and answer your questions in more depth, if there's any feedback you have on documentation, configuration, prettier icons, or anything else we might be able to do clarify or ease configuration and setup of Facebook for your Joomla site, we'd love to know it. We're always listening and trying to add powerful, yet easy to use, features.
As to your question. There's a few answers. For the 2 actions you mention (joining a group and uploading a photo), we were specifically talking about JomSocial. OurOpen Graph plugins right now have some defined actions for each extension (joining a group/uploading a photo for JomSocial; commenting/voting for K2; leaving a review in jReviews; etc). For those, you just need to configure the action that's already been defined and associate it to the corresponding object from the same plugin. When you set it as a "Manual" action (as you should), it will be triggered 'manually' whenever the user 'does' that action. Hope that makes sense...
Now, more in-depth, and what I think you're looking for even more, is adding your own action that may not already be defined by our plugins. Well, this is more difficult right now, but still possible.. depending on what you want to do. If you want an action to post when a user 'does' something in another extension, you may need to either create (or modify) an open graph plugin to add that action or implement it in the extension itself.
If you're looking to add a button to a page that a user can click to post an action, that's much simpler, though not implemented as easy as an {SCOpenGraph ...} tag.. yet. That's in the works. Going along with a cooking recipe, here's how you'd add 2 buttons for "I'm Preparing" and "I'm cooking" so that a user could read the recipe and click those buttons at different stages of the process:
* FB APP: In your FB App, create the actions of "preparing" and "cooking"
* FB APP: Create an object of "recipe" (or article or whatever you want to call it on your site) and associate those actions to it
* JFBConnect: Create the Object type of article or recipe for a Joomla article (assuming you're putting the recipes in a standard article)
* JFBConnect: Create a "New Custom Action" for "cooking" and "preparing". Set them to "manual" and associate each with the object you created above.
* JFBConnect: Take note of the 'id' of the Action(s) in the right-most column of the Actions list.
Now, you're object/actions are setup, you just need to trigger them. To do so, add the following HTML to a custom HTML module, your template, or wherever else you'd want to display a button/text link that the user can click:
<a href="#" onclick="jfbc.opengraph.triggerAction('234','http://yoursite.com/link-to-page');">I cooked this!</a>234 = The Action ID
You can replace the "I cooked this!" with an image or anything else you want there.
With that, once clicked, the same popup that we use for read actions will appear for the user. The biggest issue (and a reason we need an {SCOpenGraph ..} tag) is that the button won't change when clicked.. so there's no (easy) way to have an "Congratulations!" button that is displayed after the user clicks "I cooked".
That code above isn't directly tested and may have an issue, but if you make it that far.. post (or Private Message) a URL and we can help debug from there.
Hope that all makes sense. In the first stage of Open Graph Actions for Joomla, we were shooting more for the defined actions for extensions. The next steps (after a few more issues are ironed out) is to flush out the more 'custom' actions like described above.
Sorry for the long post. I'll likely be using this as the first-draft for the "How to make Custom Open Graph Actions" guide that we'll be posting soon.. so thanks for being the guinea pig! As already mentioned... thoughts, comments, and feedback are welcome.
Good luck, and hope your brain isn't about to explode,
Alex
Questions about Open Graph Custom Actions & Objects with JFBConnect
