Skip to main content

Pyramid routes and helpers for Facebook canvas applications

Project description

Provides simple pyramid routes/views for facebook canvas application.

Some documentation on


  1. Create facebook application on

  2. Add facebook settings in .ini file under application section and fill with facebook application parameters:

    facebook.app_id =
    facebook.secret_key =
    facebook.namespace =
    facebook.scope =
  3. In the app settings on, set callbak url to point to[facebook app namespace]/

  4. Include pyramid_facebook in your config:

  5. Define your facebook canvas view:

    from pyramid_facebook.canvas import facebook_canvas
    def canvas(context, request):
       # canvas is available only to users who accepted facebook permission
       # defined in setting['facebook.scope'].
       # context.facebook_data dict contains signed_request content.
       # i.e.:
       # user_id = context.facebook["user_id"]
       return Response('Hello Facebok World')
  6. Browse to your app on[app namespace]


2.0.2 (2014-12-17)

  • Add a test configuration in pyramid_facebook.tests which mocks facepy graph api object. To use it in functionnal tests: config.include('pyramid_facebook.tests') when configuring test app.

2.0.1 (2014-11-25)

  • Upgrade to facebook graph api v2

1.0.1 (2014-11-25)

  • Add Facebook payment event type for refunded orders.

0.6.7 (2014-08-26)

  • Remove constraint on pyramid_contextauth version requirement.

  • Add pyramid_mako as required dependency.

0.6.6 (2014-05-05)

  • Improve request property request.graph_api

  • Add request property request.fb_app_token

0.6.5 (2014-04-23)

  • 2014-04-23 - Facebook real time payment fails and logging code raises a KeyError.

0.6.4 (2014-03-26)

0.6.3 (2014-03-25)

  • Fix doc and rst file for pypi.

0.6.2 (2014-03-25)

  • Remove authentication_policy decorator in favor of config.register_authentication_policy.

0.6.1 (2014-03-24)

  • Update dependency to pyramid_contextauth >= 0.5


  • Add a GraphAPI utility lazily instantiated with the application token.

  • Add attribute ChangeNotification.object event.

  • Event OrderReceived is notified when receiving a real-time payment update

  • Add pyramid_facebook.tests.integration.test_payments used in pyramid_facebook.tests.functional.test_payments

Breaking Changes

  • Rename OrderCreated for OrderReceived

    • Can be sent multiple times for the same order with same or different status

  • Rename OrderCreationError for OrderProcessingError


  • Added pfacebook-real-time command to update real time subscriptions.

  • Breaking changes: namespace is now added by the framework in opengraph URLs.


  • Reusable view and template for OpenGraph objects.

  • Support for Facebook local currency payments.

This release is backward-compatible for apps that use the app currency and Facebook credits decorators. A future version will remove support for credits (Facebook will remove them) and app currencies (which can now use the generic OpenGraph view).


  • Packaging fix-ups.


  • Fix bug where permissions defined in facebook.scope setting were ignored by prompt_authorize.


  • Add view to redirect from GET canvas to the Facebook application page.


  • Move predicates from lib to predicates.

  • Add PermissionEventPredicate for filtering event subscriber with permission.


  • Include pyramid_contextauth for dealing with context-based authentication.


  • Added CanceledOrder when any payment update fail during event notification.

  • add includeme for any sub module to uniform configuration

  • facebook auth policy does not rely anymore on context for authentication.

  • add an CanvasRequested event triggered when a identified user request canvas.


  • In credits: Check item title not being an empty string to avoid FB failing with no explicit message. “Fail early.”

  • Fixed bug which raised configuration conflict because pyramid_facebook was not commiting config via config.commit.


  • Initial version

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pyramid_facebook-2.0.2.tar.gz (34.2 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page