In This Article:

    Send a "uid" field to a donation page via the URL

    In This Article:

      Background

      Salsa provides a unique ID field in donations called uid. The uid field is one that you provide and that Salsa does not change. The most common way that this field is used is to link a donation in a different system to the one in Salsa. Having a field in Salsa that matches a donation record in our own database makes it very easy to

      • search for a record in Salsa using the serial number from your database

      2016-02-10_1609.png

      • retrieve a record via the API,

      2016-02-10_1612.png

      • or even to find a record from a list of exported donations

      2016-02-10_1619.png

      Typically, the uid is imported into the donation table or added via an API call. However, there are business cases that need to be able to set the uid when a donation is made. If that's the case for you, then please read on!

      Solution

      The solution is to add a script to your donation page, or to your template, that looks for &uid=whatever in the donation page URL. If it appears,  Salsa will store whatever in the donation's UID field.

      Install in a donation page

      If you only have a few pages that need to have the uid passed in, then the solution can be added to each page.  Here are some steps that you can use to install into a donation page..

      1. Edit the donation page.
      2. Click on the "Optional Text" tab

      2016-02-10_1626.png

      1. Locate the Pre Submit Footer field near the bottom of the "Optional Text" page..

      2016-02-10_1628.png

      1. Scroll past anything that's already in the Pre Submit Footer and insert a blank line. If the Pre Submit Footer field is empty, then insert a blank line at the top.

      2016-02-10_1631.png

      1. Click here to see the solution page.
      2. Click on the Raw button. A new window will open containing just the script.

      2016-02-10_1636.png

      1. Copy the contents of the window, then close the window.
      2. Paste the copied text into the empty line in the Pre Submit Footer field.
      3. Save the donation page.
      4. Test!

      Install in a template

      If you'd like this solution to be applied to a bunch of donation pages, then it should appear in the template(s) for those donation pages. Here are some steps that you can use for each template.

      1. Edit a template. Click here if you need help getting started with that.
      2. Use the browser's search tool to find the </body> tag.
      3. Insert a blank line just before the </body tag.

      2016-02-10_1647.png

      1. Click here to see the solution page.
      2. Click on the Raw button. A new window will open containing just the script.

      2016-02-10_1636.png

      1. Copy the contents of the window, then close the window.
      2. Paste the copied text into the newly inserted line in the template.
      3. Save the donation page.
      4. Test!

      Usage

      To use this solution, simply add

      &uid=whatever

      to the URL for the donation page. For example

      https://wfc2.wiredforchange.com/o/8564/p/salsa/donation/common/public/?donate_page_KEY=8548&uid=TK429

      After the donation has been submitted, then the UID field appears when you edit the new donation.

      2016-02-10_1641.png

      Questions?

      If you have any questions, then please gather this information.

      • Your organization_KEY
      • Your chapter_KEY if you are in a chapter
      • If the script was installed into a donation page, then the donate_page_KEY of that donation page
      • If the script was installed into a template, then
        • The template_KEY of the modified template
        • The donate_page_KEY of a donation page that uses the template
      • A screenshot of the page, if possible.

      Send this information to support@salsalabs.com, and we'll be glad to help.

      Was this article helpful?
      0 out of 0 found this helpful
      Have more questions? Submit a request

      Comments

      0 comments

      Please sign in to leave a comment.