Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Perl
tree: 60cd541a2b

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
lib/ShipIt/Step
t
tools
xt
.gitignore
.shipit
Changes
MANIFEST.SKIP
Makefile.PL
README
README.mkdn

README.mkdn

NAME

ShipIt::Step::Facebook - ShipIt step to announce the upload on Facebook

SYNOPSIS

None.

DESCRIPTION

This ShipIt step announces the upload to Facebook.

To use it, just list it in your .shipit file. You might want to use it after the UploadCPAN step, as it is not a good idea to announce the upload before it has gone through - something might go wrong with the upload.

If this step fails - maybe Facebook is down - a warning is issued, but the shipit process doesn't die. This is because you might have uploaded the distribution to CPAN already, and it would be a shame for the whole process to die just because you're not able to facebook.

GET FACEBOOK ACCESS_TOKEN AND STORE

run tools/init.pl in this distribution.

Please follow the message of a script.

CONFIGURATION

In the .shipit file:

facebook.config = ~/.shipit.facebook
facebook.distname = Foo-Bar
facebook.message = shipped %d %v - soon at %f
facebook.target = me

You can define three configuration values for this step:

The Variables is not mandatory.

  • facebook.config

This is the location of the file that contains the Facebook access_token and Wall target_id in YAML style. The first tilde is expanded to the user's home directory. An example file could look like this:

access_token: ACCESS_TOKEN
target: me

The access_token is mandatory.

default '~/.shipit.facebook'

  • facebook.distname

This variable is optional; it is the distribution's name. If the variable is not defined, the step will try to read the distribution name from the META.yml file.

  • facebook.message

This variable is optional; it is the message to send to Facebook. You can use placeholders, which will be expanded. If the variable is not defined, this default message will be used:

shipped %d %v - soon at %f

The following placeholders are recognized:

- %d

Will be expanded to the distribution name that you defined in
`facebook.distname`.

- %u

Will be expanded to the distribution's CPAN URL - if the distribution name is
`Foo-Bar`, for example, the URL will be
`http://search.cpan.org/dist/Foo-Bar`.

- %f

Will be expanded to the distribution's FrePAN URL - if the distribution name is
`Foo-Bar`, for example, the URL will be
`http://frepan.org/dist/Foo-Bar`.

- %v

Will be expanded to the version of the distribution you're shipping.

- %%

Will result in a percent sign.
  • facebook.target

you can select Wall page in message write.

When you want to carry out POST to Wall of http://www.facebook.com/kazuhiro.osawa:

facebook.target = kazuhiro.osawa

When you want to carry out POST to Wall of http://www.facebook.com/pages/Yappo/200453809970361:

facebook.target = 200453809970361

AUTHOR

Kazuhiro Osawa

SEE ALSO

many code takes from ShipIt::Step::Twitter

LICENSE

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

Something went wrong with that request. Please try again.