Knowledgebase

Creating Theme Customizations with Config Files

No comments

The following article is intended for theme developers only. If you’re not familiar with HTML, CSS, and JavaScript, it might just look like gobbledygook.

We’ve said it before, but we’ll say it again. One of our favorite features of GiftFold is its endless customization. In this article, we’re going to share a little bit about config files.

JonCreating Theme Customizations with Config Files
read more

Adding Donor Logins to Your Theme

No comments

The following article is intended for theme developers only. If you’re not familiar with HTML, CSS, and JavaScript, it might just look like gobbledygook.

To enable the donor registration and login feature in GiftFold, follow these 3 steps:

1. Add a Sign-In Form to Your Theme’s Layout

We suggest you place a simple, inline form in the upper, right hand section of your layout. Users will expect to find it there, while visitors won’t feel like they have to login. To make it less obtrusive, you might consider hiding the form behind a “Login” link using JavaScript.

Here’s some code you can copy and paste into your theme to add a sign-in form (and sign out option if the visitor is already signed in):

{% if donor %}
<div>Signed in as {{ donor.email }}. <a href="{% signout_url %}">Sign Out</a></div>
{% else %}
{% signin_form %}
<label for="session_email">E-mail Address</label>
<input id="session_email" name="auth_key" placeholder="E-mail address" type="text" />
<label for="session_password">Your Password</label>
<input id="session_password" name="password" placeholder="Your password" type="password" />
<button type="submit">Sign In</button>
{% endsignin_form %}
{% endif %}

2. Add a Password and Password Confirmation Field to Your Form

Once your donors know they can sign-in, they will want to know how to register. Fortunately, we’ve made this process extremely simple for the donor. All they will need to do is add a password to their donation.

To add Donor Registration to your GiftFold theme, simply add these two inputs to your form template (templates/form.liquid):

<input name="donation[password]" type="password" value="{{ donation.password }}" />

and

<input name="donation[password_confirmation]" type="password" value="{{ donation.password_confirmation }}" />

If you want to go a step further, hide these inputs behind a “Click here to create an account” checkbox with some JavaScript.

3. Tell Your Donors

Once you’ve implemented the registration and login feature, you might want to tell your donors about it. We suggest you email them and let them know. It will give you another reason to talk them, and it might encourage them to come back and make another donation.

And that’s all! Pretty simple, right?

JonAdding Donor Logins to Your Theme
read more

Enabling Authorize.Net Silent Posts

No comments

If you are using the Authorize.Net gateway, you can setup Silent Posts to track recurring gift transactions in GiftFold. By default, GiftFold is only aware of the initial setup of a recurring gift. Silent posts, however, enable you to see every subsequent recurring transaction as well. This will not only make your reports more accurate, you will be able to easily export the data from GiftFold rather than trying to export it from Authorize.Net.

JonEnabling Authorize.Net Silent Posts
read more

Give Donors a PayPal Option

No comments

With GiftFold, you can provide donors with two options for payments: credit card and PayPal. By accepting PayPal payments in addition to credit card payments, you can better reach constituents who feel more comfortable giving with PayPal.

JonGive Donors a PayPal Option
read more

Getting Started with Custom Themes

No comments

One of our favorite things about GiftFold is the ability for our customers to fully-customize every last piece of HTML their donors see. And not just HTML; our customers can use any number of custom images, scripts, and stylesheets. With a robust theme engine using Liquid code and Amazon’s CloudFront CDN, we charities to create highly optimized and beautiful donation forms. So here’s what you need to know to get started.

JonGetting Started with Custom Themes
read more

Liquid Reference for Theme Developers

1 comment

The following article is intended for theme developers only. If you’re not familiar with HTML, CSS, and JavaScript, it might just look like gobbledygook.

As a theme developer, you need more than HTML, CSS, and JavaScript. You need access to campaign statistics (e.g. campaign goals vs amount actually raised), donation errors (e.g. invalid credit card), and receipt information (e.g. card expiration date). GiftFold gives you access to this data in the form of liquid objects.

Liquid is a template language developed and openly shared by the fine folks at Shopify. If you’re not already familiar with liquid, we suggest you check out Shopify’s article, Liquid Basics. If you’re already familiar with liquid, use the following reference to help you develop custom themes for GiftFold.

JonLiquid Reference for Theme Developers
read more