Qgiv Online Qgiv Kiosk Peer-to-Peer Givi Partners

How Do I Create My Own Facebook App for Use with Custom Domains?

Creating and using a custom Facebook app for use in the Qgiv system will allow you to customize the display of content shared from our system, as well as view and own the data associated with the shared content. 
 
The following document outlines the steps needed for creating a custom Facebook app for use in the Qgiv system.
 
Creating the Facebook App
  1. Follow steps 1-3 from the Facebook developer documentation to signup as a Facebook developer and create your app: https://developers.facebook.com/docs/apps/register
    • When you are prompted to choose a platform, select “Website."
  2. App Settings
    • Display Name: The name of your app. This will be the name displayed as the source of shared content within Facebook.
    • Namespace: Facebook requires you to create a unique identifier for your app. This field can only contain lowercase letters, dashes, and underscores. For example, if your organization’s name was “The Human Fund," your namespace might be “thehumanfund"
    • App Domains: This is the custom domain you’ll be using within the Qgiv system, without the “https” part. For example, if your domain was “https://donate.example.org,” you would enter “donate.example.org”
    • Contact Email: Enter your preferred email address should an issue arise with your app.
    • Privacy Policy URL: You may provide your own or use https://www.qgiv.com/privacy-policy.
    • Terms of Service URL: You may provide your own or use https://www.qgiv.com/acceptable-use-policy
    • App Icon: Upload a custom image that is 1024 pixels wide by 1024 pixels high. This is the image associated with your app when users try to register using Facebook, so it’s recommended you use something like your organization’s logo.
    • Category: Please select “Apps for Pages."
  3. Website Platform Settings:
    • Site URL: Please enter the URL you are mapping to the Qgiv system.
  4. Once your app has been created, provide us with your App ID, App Secret, and App Namespace.
 
Submitting for Review
 
Once you’ve completed setup of your app, you’ll need to submit it to Facebook for review. This process is managed by Facebook, and may take 3-5 business days.
  1. In the sidebar on the left, click “App Review."
  2. Make sure you select “Yes” to make your app public, and under "Current Submission," add the following items with accompanying notes:
    • Login Permissions
      • publish_actions
        • Check all confirmation boxes
        • Under the “How is your app using publish_actions?” question, please select “Lets people post to Facebook using a custom composer"
        • Select “Web” for platforms, and in the notes section copy and paste the following: This app is a white label solution of the Qgiv app. The Facebook integration can be tested by doing the following:
          1. Visit: https://secure.qgiv.com/event/620610/register/.
          2. Click “Register Using Facebook” and complete the registration process.
          3. Visit your fundraising dashboard, go to "Share Event", set up a scheduled or manual Facebook post.  
        • Download the screencast from Dropbox and upload the screencast in the specified area.
    • App Verification
      • Enter the following in the "Notes" section for the App Verification item:
        • This app is a white label solution of the Qgiv app. The Facebook integration can be tested by doing the following:
          1. Visit: https://secure.qgiv.com/event/620610/register/.
          2. Click “Register Using Facebook” and complete the registration process.
          3. Click the "Submit for Review" button.
Have more questions? Submit a request
Powered by Zendesk