DOCUMENTATION

WooCommerce

WooCommerce

Installation Instructions

Note: To install our WooCommerce extension you will need to have admin access to your store.

1Go to your store's admin and then on the left side nav look and click in Plugins.

2Click on Add New.

3On the search bar, type in rejoiner to look for our extension.

4Next, you will see the following result show up. There, you will want to click on Install Now button.

5This will install the plug in, but you will still need to activate it and connect it to your Rejoiner account.

6To activate it, simply go back to your plugins listing. Look for WooCommerce Rejoiner and click on the Activate link.

Configuration Instructions

1Sign into your Rejoiner Account and click Settings. Copy your Rejoiner Site ID.

Site ID abc123xs
API Key edoct-erces-repus-87654

2Upload, and activate the WooCommerce Rejoiner plug-in to your WooCommerce instance.

3Back in your WooCommerce store's Admin, look for WooCommerce Settings in the left side nav. Then click on the Integration tab, click on the Rejoiner link.

4Enter your Rejoiner Site ID, Domain & API Secret.

Note: Rejoiner2 clients can leave the API Secret value blank.

5Finally, make sure you save your settings by clicking on the Save Changes button at the bottom of your Integration tab.

If you offer PayPal as a payment option, please verify that Auto Return is activated by following these instructions.

Advanced Features

Product Image Size

The standard image size (width and length) you are passing us will vary according to your Wordpress theme. However, sometimes you will want to pass us larger image sizes in order to avoid pixelated images showing in your creative–this also helps with rendering images for retina display devices.

Please follow the instructions below to modify the image size you are passing us.

1Go into your theme's functions.php file.

2Next, add the following code into your file.

// Use this filter to specify the image size to be passed to rejoiner.
add_filter( 'wc_rejoiner_thumb_size', 'my_wcrj_thumb_size' );
function my_wcrj_thumb_size( $size ) {
    return array( IMAGE WIDTH HERE, IMAGE HEIGHT HERE );
}

3Next, substitute the text IMAGE WIDTH HERE and IMAGE HEIGHT HERE with the correct width and height you want to use.

Note: You can return a named image size, eg: 'medium' or an array of dimensions, eg: array ( 800, 600 )

An example of the code snippet using width and height:

// Use this filter to specify the image size to be passed to rejoiner.
add_filter( 'wc_rejoiner_thumb_size', 'my_wcrj_thumb_size' );
function my_wcrj_thumb_size( $size ) {
    return array( 800, 600 );
}

An example of the code snippet using named image size: (You must add single quotes to the named image size)

// Use this filter to specify the image size to be passed to rejoiner.
add_filter( 'wc_rejoiner_thumb_size', 'my_wcrj_thumb_size' );
function my_wcrj_thumb_size( $size ) {
    return array( 'medium' );
}

4Next, save your theme's functions.php file.

5To confirm that the change has taken place follow these instructions and verify the image size using the set_cart_item call, which looks like so in your Chrome Dev Tools.

6Next, copy the image_url address in a new browser tab

7Lastly, right click the image and select "inspect" to see the actual image dimensions.

Send Converted Customers to a List

Our integration with WooCommerce allows you to push all customers who complete a purchase to a specific Rejoiner List.

Note: You will need to create a List for these customers in your Rejoiner account before employing the steps below.

1Go to your Admin and on the left side nav look for WooCommerce, then click on Settings.

2Next, click on the Integration tab.

3There you will see a section named Send Converted Customers to a List. We will want to select the Send all new customers who complete an order to Rejoiner option, in order to enable this feature.

4Once it's been selected, simply add the List ID of your Rejoiner List in the input below it.

5Finally, make sure you save your changes by clicking on the Save Changes button at the bottom of your Integration tab.

Accept Marketing Feature

Our integration with WooCommerce allows you to push all customers who opt into your marketing to be sent to a specific Rejoiner List. This will then allow you to send against that list in order to respect your customers' wishes.

Enabling this feature creates a simple checkbox for your customers to opt into your marketing. The checkbox then gets added into several parts of your store in order to be able to maximize this feature.

Note: You will need to create a List for these customers in your Rejoiner account before employing the steps below.

1Go to your Admin and on the left side nav look for WooCommerce, then click on Settings.

2Next, click on the Integration tab.

3There you will see a section named Accept Marketing Feature. We will want to select the Yes, enable Rejoiner to gather marketing permissions from customers at checkout option, in order to enable this feature.

4Once enabled, we can update the remaining options of this feature.

5 We recommend you update the Opt-In Field Label in order to set up the text you'd like to use for your opt-in checkbox.

6The next option is the Opt-In Status. This simply refers as to whether the checkbox should be selected or unselected by default. We recommend you leave it unselected, or as per the options shown below, leave it as Disabled by default.

7Next, you should add the List ID of the Rejoiner List you want to send your subscribers to.

8Finally, we need you to decide where Rejoiner should inject the opt-in checkbox on your site. We recommend you select all the options given in your Opt-In Options section as pictured below:

9Finally, make sure you save your changes by clicking on the Save Changes button at the bottom of your Integration tab.

Back to Top