CartFlows 文档

How to Start a Flow From Product Page

If you are looking to start your flow right from the product』s page then this new update is for you. 

Here in this article, you will get an idea of how you can start your flow from the product』s page and how you can use it with different types of Products. 

In this feature, we have added one CartFlows setting under the product』s setting in WooCommerce. Using this setting you need to search for the flow to which you want to connect it to the product.

After selecting the flow in the product』s setting, when the user visits that product』s single page to add it to the cart for the purchase by clicking on add to cart button, he will be redirected to the CartFlows flow』s first step which is present in the selected flow.

While using the feature, we recommend not to use the landing page, so that when the user adds the product to the cart he will be redirected to the checkout page immediately instead of the landing page.

This feature will also help to solve the issue with the Name your price, Booking or Appointments related product types in the following way.

For example: 

If you are using the Name your price plugin, then this plugin adds an input field on the single product』s page. Now, you have to select the Flows to which you want to redirect the user after adding this product to the cart. 

When the user adds his price in the field and clicks on the add to cart button, then that product will be added to the cart with the same price which the user has added in the field. 

The same working will be experienced with the booking or appointment products type. The user has to select the page and provide all the information on the single product』s page and then the same can be purchased from the CartFlows checkout page.

Note: While using this feature, there should not be any product selected in the backend setting of the checkout page. I:e no products should be selected on the checkout page.

Let』s see how we can enable this feature and start the flow right from the single product』s page.

Step 1: Create a flow and make sure that you have set the checkout step as a first step.Step 2: Navigate to the edit product page to which you want to connect it with the flow. Step 3: Find and open the CartFlows tab

Step 4: Search for the Flow to which you want to connect the product and can change the add-to-cart button text for that product as well.

Step 5: Done. Save the changes by updating the Product.

How To Install CartFlows Pro?

Below are the steps to install the CartFlows Pro on the website.

First, login to your account on my.cartflows.com website and download the CartFlows Pro zip from Downloads Menu.Now, login to your websie and go to Plugins -> Add New.Click on upload plugin button on the top of the screen.Select the cartflows-pro.zip file and click upload.Once the zip is uploaded, you can activate the CartFlows Pro plugin on the website.

Note: CartFlows free version is required by the CartFlows Pro plugin to enable all of the Pro features.

How to Pre-Fill the Checkout Fields via URL Parameters.

We are introducing a new feature to pre-fill the checkout fields via sending contact information from URL parameters. After many requests, we decided to integrate it in the CartFlows, and in this article, we will see how to set it up and how to use it.

So, let』s begin…

This feature is enabled by default in the CartFlows. So, you just need to send the parameters from the URL on the checkout page to pre-fill the checkout fields on the CartFlows checkout page.

Remember, this feature works on the CartFlows Checkout page and not on any other page.

To send the values from the URL parameters, you can use any contact form to send the values in the URL after successful submission.

Now, while using the contact form or any other medium you need to ensure that to create a proper checkout page URL so that your data will be automatically pre-filled on the CartFlows Checkout page.

For example, If you want to send the user』s email address, first name then your checkout page URl should be created as follows:

https://yourdomain.com/checkout-page/[email protected]

There are few fields names which you can use to send the data in the URL to capture it on the CartFlows Checkout page and they are listed below.

List of Billing Fields

billing_emailbilling_first_namebilling_last_namebilling_phonebilling_address_1billing_address_2billing_citybilling_postcodebilling_countrybilling_statebilling_company

List of Shipping Fields

shipping_emailshipping_first_nameshipping_last_nameshipping_phoneshipping_address_1shipping_address_2shipping_cityshipping_postcodeshipping_countryshipping_stateShipping_company

If you don』t want to use this feature then we also have provided a filter to disable this feature on the CartFlows Checkout page. Please note that disabling this feature using the filter will disable it from all the available checkout pages.

Below is the code which you can use to disable this feature. After copying this code you have to add it in your child theme』s functions.php file at the very end of it.

add_filter( 'cartflows_auto_prefill_checkout_fields', '__return_false' );

This article will help you to add the custom PHP code on your website.

How to Import the Ready-Made Templates for Flows and Steps in CartFlows?

In this article, you will learn how to import the ready-made Flow and the Step templates of CartFlows. Currently, we have provided the ready-made templates for the following page builders:

ElementorDIVIBeaver BuilderGutenbergThrive Architect

You can import the templates for Elementor, DIVI, Beaver Builder & Guttenberg from the CartFlows template library but for the Thrive Architect templates you need to login to your account on the website and download the ready-made templates zip from the Downloads Tab.

Now, lets see the whole process, how to import ready-made flow and step templates.

Import the Ready-Made Flows templatesImport the Ready-Made Step templatesSome Frequently Asked Questions

How to import the Ready-Made Flows templates?

Step 1: Select your favourite Page Builder that you want to design the CartFlows step pages. For selecting the page builder navigate to the CartFlows [WordPress Menu] -> Settings.

Step 2: Now, navigate to the CartFlows [WordPress menu] -> Flows.

Step 3: Click on the Add New button on the top of the screen to view the templates for the page builder that you have selected in the Step 1.

Step 4: On clicking the button a template library will be displayed in the popup containing the templates.

Step 5: Now, hover over to the template that you want to import and click on the import button. This will start importing the Flows template.

The Above steps will help you to import the ready-made flow templates for all the Page Builders that we have mentioned at the start of this article.

How to import the Ready-Made Step templates?

While importing the new ready-made templates for the steps, your page builder setting must be set otherwise this will not show the templates.

So, let』s move further and see how to import the ready-made step templates.

Step 1: Navigate to your flow in which you want to import the new step. As mentioned in the screenshot, we have used the flow name as Test Flow.

Step 2: Click on Add New Step Button. This will display the same popup but it will display you only the templates. Such as Landing, Checkout, Option, Upsell, Downsell and Thank you pages.

Step 3: A template library will be opened in the popup

Step 4: Select the step category from the menu. Using this you can decide which page template you want to import.

Step 5: Hover on the template that you want to import and click on the import button and the importing process will be started.

While importing the flow templates or step templates for the desired page builder, you might face some error messages or notices. Don』t worry, they will not be fatal just a message to know the status of the importing process. 

While importing the templates, if you face internet connectivity issues or any other issue so in that case you can just reload the page and try importing the Step / Flow again.

Frequently Asked Questions –

Below are some common error messages that  you may face while importing the templates.

Failed to import the template: This message will be displayed on the button or an error message will be generated in the browser』s console area.To fix this issue, you will need to reload the page and try importing the template again. This will refresh the cache and the library will be updated so that you can import the template again.Internal Server Error: This error denotes that there is something wrong with code execution and returned 500 Internal Server Error. To find the exact cause of this error, you will need to navigate to your server』s root directory and then to your wp-content folder. In this folder there will be a file named as debug.log file. This file stores the error messages generated while execution of the code.

Under maintenance error message: This message will be displayed in two cases The first one is that our server is under routine maintenance or there might be a request error that will be displayed in the browser』s console area. This error prevents the API call to our server to fetch the templates.

How to Hide Checkout Fields from the Checkout Page?

In the CartFlows checkout step, there is an option to hide any of the fields that appear in the checkout form.

To hide the fields on the checkout page, below are the steps –

Step 1: Navigate to CartFlows -> Flows -> edit your_flow -> Edit Checkout page.

Step 2: Navigate to the Form Fields tab & then enable the option – Enable Custom Field Editor if it is disabled.

Step 3: Click on the eye icon to Hide/Remove the fields from the checkout page.

Step 4: Click on the Save/Update button and it is done.

List of CartFlows Cookies

The cookie is a small file created by software or a website to store the data on the user's local device for identification.

When a page request is made from one device via the browser, the same cookie is gets sent in the same page request too.

There are some cookies that are used by the CartFlows for the smooth working of some of the CartFlows features.

There is a total of 5 cookies used in the CartFlows and below are the names of those cookies:

cartflows_session_ : This cookie is set when you visit the CartFlows page. This is registered to set the unique session per user so as to make the checkout process smooth.wcf_active_checkout : This cookie is set to determine which checkout page is currently opened and what's the cart data for that specific checkout page.

For tracking the flow analytics in the CartFlows, there are certain cookies are used. These cookies are as follows:

wcf-visited-flow- : This cookie is used to track which flow is currently being tracked.wcf-step-visited- : This cookie is used to track which step is currently tracked.cartflows-ab-test- : This cookie will only be set when the A/B split test feature is enabled.

If your server has specific requirements which require the cookie name should be started with the specific prefix then you can either exclude these cookies from the Server cache or use the following small piece of code to add the prefix to the cookie name.

define( 'CARTFLOWS_COOKIE_PREFIX', 'your_prefix_' );

Note: You need to add this code inside the wp-config.php file and just about the 「That's all, stop editing! Happy publishing」 line/statement. This file is available in the root directory of the website/server.

How to Upgrade to CartFlows Pro Lifetime?

If you are looking to upgrade your existing CartFlows Pro annual license to lifetime, please follow the below steps –

Step 1: Login to your account on CartFlows store.

Step 2: Click on the Subscriptions option from the Sidebar

Step 3: You will see a list of your active Subscriptions. Now click on the View option of the CartFlows – Annual license.

Step 4: Now, click on the Upgrade to Lifetime option on the banner as shown below.

Note: You will see the reduced price on the checkout page when you click on Upgrade to Lifetime.

Step 5: Complete the payment with Billing and Payment details and your CartFlows Pro license will be upgraded to the Lifetime plan!

Frequently Asked Questions!

What will be my final upgrade price?=> Once you click on the Upgrade option and select the Lifetime deal and proceed you will find the final price on the Checkout page. It will display the price deducting your current subscription.

Why I can』t see the Upgrade button?=> This could be in the following cases —1. When your current subscription is not active 2. Or your subscription might be refunded 3. You might have monthly or lifetime split payment subscriptions in your account.

Note: We are allowing upgrades only from CartFlows Pro Annual $239 plan to CartFlows Pro Lifetime $999 plan.

Request Timeout Error while Importing the Flow/Step Templates.

The flow templates are not getting imported? Then you are on the right article. This will help you to fix this connection timed out error message. Let』s check what this error is about and how to fix it.

This message will be displayed while importing the flow』s ready-made templates.

This problem is a very common server related issue. In most of the cases not created by a particular theme or plugin, nor by WordPress.

WordPress uses something called cURL to communicate with other websites, specifically using this function: wp_remote_get()

This is a core WordPress function that we use to import the ready-made templates from our website to your website. When you click to import the flow, an API request is made to our templates.cartflows.com website to get the requested flow template.

If this API request is blocked then you will get the connection timeout error and the flow will not be imported.

It』s necessary for your website to communicate with our website, to ask for the ready-made template and once the API request is successfully received and processed by our server, we serve the requested flow to your website in the response of the API request..

When cURL times out, it typically means one of the two websites is blocking that communication. This can happen via firewalls or other means of server security.

To debug this issue, If you see that the Flow is not getting imported and the import button is saying Importing Template for a long time then check is there any error in the browser』s Console tab.

If you don』t get the console error then the error message will be automatically displayed on the flow import popup as displayed in the above screenshot.

To fix this issue, there are different ways. Let's check the first and the main way due to which this type of error occurred.

Make sure that the firewall or any security-related plugins are not blocking the outgoing API requests.If you are using such plugins then try disabling them for a short time.Ask your host if there are firewalls or security modules (e.g. mod_security) that could block the outgoing cURL requests.If it is blocking the outgoing API request to our server then you need to whitelist our website which is template.cartflows.com from your end so that the API call may not get blocked.If no firewall or security plugins are installed then you can check for the alternate solutions as follows.Make sure your server is running a recent version of PHP and the cURL library.Try increasing your PHP memory limit.Try increasing your cURL timeout limit.Ask your host if there is some limitation with wp-cron, or if loopback is disabled.Install the Query Monitor plugin and check the status of the HTTP API Calls in the admin page where the error is displayed.

If you are using managed WordPress hosting, then below are the solution you can try.In the managed WordPress hosting, the hosting provider restricts the execution time and the memory limit of the server, which can generate a curl 28 error message. Check with the hosting provider that the outgoing WordPress HTTP REST API requests are blocked or restricted or not. If they are restricted then ask them to exclude them from their CURL tool to solve this curl 28 error on your website

If none of the above points fixes the issue, then you will need to ask your hosting support to confirm that your server can communicate with our templates server which is templates.cartflows.com via cURL without any limitations.

If still not working then please open a support request from our website and share your website』s IP address with us so that we can check if is it banned from our server or not. But in most cases, this does not happen at our server, because our server is made to handle tons of requests of such types.

How to Translate CartFlows in Your Own Language using GlotPress?

CartFlows is 100% translation ready, comes with .po / .mo files, and can be translated using any software such as POEdit, GlotPress, Loco Translate, TranslatePress, etc. Out of them all, we recommend GlotPress.

GlotPress is an online software that is used by WordPress for translations. The best part of GlotPress is the community. Anyone can login to GlotPress and contribute in translating the project, suggest corrections, validate existing translations. As a outcome of this, projects are usually translated faster and in more accurate manner.

In the post below, I will explain how GlotPress works and how you can use it to translate CartFlows in your own language.

Step 1. Visit the GlotPress Project.GlotPress for CartFlows plugin is hosted on WordPress Repository here and CartFlows Pro can be translated here.

Step 2: Login or Register a new account.

Step 3: Choose your language from the list. (Screenshot)

On the language page, you will see the current state of translation of the language and list of other translators who might have already translated contributed in translating the project. You might find some other terms as well which might not be very obvious. So let me explain what they mean.

Untranslated: are the strings that are not yet translated by anyone and need work.Waiting: are the strings that are translated by contributors, but yet need approval by the validators.Fuzzy: is a string that is marked as fuzzy if it is translated differently by different translators. The language validator (admins) can choose the best string out of such duplicates to mark it translated.Translated: Strings that are already translated and don』t need any further work.

Step 4: Click on the name of your language to see all available strings (Screenshot)

Step 5: Click on any string and translate it Once you translate the strings, project validators take a look at them and approve them.

Once the validator approves the translations or makes updates, the latest transnational automatically appears as an update in the WordPress backend if the project is on WordPress.org Repository. For projects that are not on the WordPress.org Repository (like CartFlows Pro Addon Plugin), project developers usually ship the completed translations through their project files with the updates.

 Would you like to become a Translation Validator?

If you』re interested in becoming a validator, please get in touch with us with the details as below –

Your WordPress.org usernameYour username on our GlotPress Portal here.The locale you would like to become a validator for.Details of your previous translations, etc if you have any.

Once you submit the request, we can get you added as the translation validator. Translation validators are able to approve the translated strings so they can be shipped to all users.

 Need to add translation in your project immediately?

Should you wish to implement this translation in your website immediately, you can export the current translation file in the .po & .mo format and use it on your website by uploading it to the languages folder using FTP / SFTP with the correct naming convention.

For themes: wp-content/languages/themes/For plugins: wp-content/languages/plugins/

Correct naming convention is very important. This will make sure that WordPress understands what language you are referring to. Be sure to prefix the text domain before the language code. Capitalization is also important here.

For language codes, please refer to this list.Text domain can be found in the style.css file of the theme, or the main PHP file of the plugin.

Examples of file names for CartFlows plugin –

For German: 「cartflows-de_DE.po」 & 「cartflows-de_DE.mo」For French: 「cartflows–fr_FR.po」 & 「cartflows–fr_FR.mo」

Please note, we』re adding translation files in the /wp-content/languages/ directory. Many tutorials on other websites might ask to upload the file inside a theme or plugin』s folder. However, it』s not a recommended way as, with every theme or plugin update, you will lose all the translations and edits you have done.

GDPR Compliance

CartFlows offers three features where we help store owners collect data in order to serve shoppers:

Checkout FormsWe use WooCommerce checkout forms and save the data in the local storage feature of modern browsers, so if users accidentally refresh the page, the data users have typed in the form won't be lost. As far as we understand, this does not violate GDPR compliance.Thus if you wish to disable this feature then this article will help you.AnalyticsWe provide analytics feature for our customers so they can see how their Flows are working and improve accordingly. This does not track any personal data of website visitors.For tracking the flow analytics in the CartFlows, there are certain cookies are used. These cookies do not stores a any of such data which may be vulnariable to the user's website nor stores any contact data. These cookies are as follows:– 『wcf-visited-flow-『 : This cookie is used to track which flow is currently being tracked.– 『wcf-step-visited-『 : This cookie is used to track which step is currently tracked.– 『cartflows-ab-test-『 : This cookie will only be set when the A/B split test feature is enabled.

There are few more cookies that are used or registered while using the CartFlows and these cookies also do not violate GDPR compliance. Those extra cookies are as follows:

– cartflows_session_ : This cookie is set when you visit the CartFlows page. This is registered to set the unique session per user so as to make the checkout process smooth.– wcf_active_checkout : This cookie is set to determine which checkout page is currently opened and what's the cart data for that specific checkout page.

As we're not legal experts, we advise our customers to consult their lawyers on these three features CartFlows offers, for further compliance with GDPR.

For further reading regarding WooCommerce and GDPR, here is a helpful article https://woocommerce.com/gdpr/

For more information on the cookies and GDPR compliance in the Cart Abandonment Plugin, this article will help you.