Funnel Builder Add-on: What It Does
The Funnel Builder is an add-on for the Free Consumer Reports plugin. It lets you make your own opt-in funnels with your own PDFs and run them next to the report funnels that come with the plugin.
Every funnel you build gets:
- A squeeze page (the opt-in page)
- A download page with a button to your PDF
- Your own PDF lead magnet, stored on your site
- A cover image, if you add one
- Privacy Policy, Terms and Disclaimer pages, linked in the footer
What you can do with it:
- Build one funnel at a time with a 6 step wizard
- Build many funnels at once from a CSV file
- Add your own categories next to the 8 report niches, and change the emoji and badge colour of any of them
- Choose from 9 page templates: Gradient, Clean Card, Dark Professional, Bold Vibrant, Minimal, Modern Glass, Neon Cyber, Warm Sunset and Corporate Blue
Your custom funnels work like the report funnels. They use the same autoresponder, the same web address prefix, the same on/off switch on the Funnels tab, and they show on your Showcase page in their category.
Funnel Builder: Install And Add Your Key
Before you start:
- WordPress 5.6 or later and PHP 7.4 or later.
- The Free Consumer Reports plugin installed, activated and licensed. The add-on does nothing on its own.
- A licence key that includes the Funnel Builder add-on. This is its own key, separate from your report niche keys, unless your package already includes it.
- Permalinks set to Post name (Settings > Permalinks). Funnel pages do not open with Plain permalinks.
- Your autoresponder connected in the main plugin. Custom funnels send opt-ins to the same place as your report funnels.
- An administrator login.
- Your PDF lead magnet, as a file or as a direct link to the PDF.
- Optional: a cover image, square or portrait, at least 400 by 400 pixels.
Install and activate:
- Log in to your members area and click Download the Funnel Builder add-on. You get free-consumer-reports-funnel-builder.zip. Do not unzip it.
- Make sure the Free Consumer Reports plugin is already installed and active.
- In WordPress go to Plugins > Add New > Upload Plugin.
- Choose the zip file and click Install Now, then Activate Plugin.
Add your Funnel Builder key:
- Go to Free Consumer Reports > Settings and find the License panel. If the main plugin has no key yet, the licence screen opens as soon as you click Free Consumer Reports.
- Paste your Funnel Builder key into the key box.
- Click the button next to it. It says Activate, or Add another key if a key is already on the site.
Your other keys stay in place. Keys stack, and the table under the panel lists each key and what it unlocks. When it worked, the panel says “Funnel Builder add-on included.” and that key’s Unlocks column says Funnel Builder add-on.
How to check it worked:
Open the Free Consumer Reports menu. You see four new items: Funnel Builder, CSV Import, My Custom Funnels and Categories. The plugin’s tab bar shows Funnel Builder ACTIVE on the right, and the Diagnostics tab shows Free Consumer Reports Funnel Builder Addon: Active v1.0.4.
Updates arrive in Dashboard > Updates, like any other plugin.
Funnel Builder: The My Custom Funnels Screen
Open it from Free Consumer Reports > My Custom Funnels, or click the Funnel Builder ACTIVE tab on the right of the plugin’s tab bar.
The first time, you see two cards. Create New Funnel (Start Wizard) opens the wizard. Import from CSV (Upload CSV) opens CSV Import. There is also a Manage Categories link at the bottom.
Once you have funnels, the screen shows:
- Two counters: Total Custom Funnels and Enabled.
- Buttons: + Create New and Import CSV.
- A Search funnels box that filters the table as you type.
- A table with Cover, Title (with its web address under it), Category, Template, Created, Status and Actions. The newest funnel is at the top.
The action buttons:
- Edit opens the funnel in the wizard, with everything filled in. Change the text, PDF, cover image, template or colours, then click Update Funnel.
- Settings opens the funnel’s page in the main plugin, the same page you use for report funnels. There you can set the autoresponder and list for this funnel, its offer links, the headline, background colour and page template.
- Delete opens a box called “Delete this funnel?”. Click Delete Funnel to remove the funnel and all its files: squeeze page, download page, PDF and cover. This cannot be undone.
To switch a custom funnel off or on, use its switch on the main plugin’s Funnels tab, next to your report funnels. New funnels are switched on as soon as you save them. The Status column shows Enabled or Disabled.
Funnel Builder: The 6 Step Wizard
Open it from Free Consumer Reports > Funnel Builder, or click + Create New on My Custom Funnels. The six steps show across the top: Basic Info, Upload PDF, Cover Image, Choose Template, Customize, Preview & Save. Use Next and Back at the bottom to move between them. Back to Funnels at the top takes you to My Custom Funnels.
Step 1, Basic Info:
- Funnel Title (required). The funnel’s name, used on the pages and in the admin.
- URL Slug. Fills in from the title, or type your own. It shows the address, for example yoursite.com/reports/your-title/, and says Available or Already taken.
- Category. Pick one of the 8 report niches or one of your own categories. To add one without leaving the wizard, pick + Create New Category at the bottom of the list, type a Category Name, change the Emoji Icon if you like, and click Create Category. It is added to the list and chosen for you. Cancel closes the box.
When you save, the funnel gets the address in URL Slug. If that address is already in use, a number is added to the end, for example -2.
Step 2, Upload PDF:
- Upload PDF: click Choose PDF from Media Library, upload your file or pick one, then click Use this PDF. The file name shows with a Remove button.
- External URL: paste the link in PDF URL. You see Valid PDF URL, a warning that the link does not end in .pdf (it may still work), or Invalid URL.
When you save, the add-on copies the PDF into the funnel’s own folder on your site. A link must be a direct, public link to the PDF file itself, not a share page.
Step 3, Cover Image (optional):
- Upload Image: click Choose Cover Image and pick an image. Remove Image clears it.
- External URL: paste a link in Cover Image URL. It must start with http:// or https://. A preview shows below.
The cover shows on the squeeze page and the download page, as the funnel’s card picture on your Showcase page, and as the thumbnail on My Custom Funnels. A 3D report or ebook image works well. With no cover, the pages simply leave the picture out.
Step 4, Choose Template:
Click one of the 9 template cards: Gradient, Clean Card, Dark Professional, Bold Vibrant, Minimal, Modern Glass, Neon Cyber, Warm Sunset or Corporate Blue. The chosen one gets a purple border. Gradient is chosen to start with. Every template is mobile friendly and uses your accent colour.
Step 5, Customize:
- Headline (required). Filled in as “FREE: ” plus your title. The big text at the top of the squeeze page. Once you change it, your own headline is kept, also when you go Back and return to this step.
- Subheadline. The line under the headline.
- CTA Button Text (required). Starts as “Get Free Access”.
- Popup Headline. The text above the email box in the opt-in popup. Starts as “Get Your FREE [your title] (Enter Email)”.
- Accent Color. The main colour of the page.
- Affiliate Link (optional). Used for the Check Out This Resource button on the download page. Leave it blank to use your Geo Smart Link, which follows the Geo Smart Links and Default Affiliate Link in the main plugin’s Settings. If none of these are set, that box is left off the page.
- Gradient Start Color and Gradient End Color. These only show when you picked the Gradient template.
Step 6, Preview & Save:
- Click Generate Preview. Your squeeze page appears in the box.
- Use the Squeeze Page and Download Page buttons to switch between the two pages.
- Click Save Funnel.
You see “Funnel created successfully!” with the funnel’s link, the exact address it was saved under, plus Create Another and View Funnels buttons. The preview shows the Check Out This Resource box only when you typed an Affiliate Link in Step 5. The live page also uses your Geo Smart Link.
Editing a funnel later:
Click Edit next to the funnel on My Custom Funnels. The wizard opens as Edit Funnel with everything filled in. Change what you like, then click Update Funnel on Step 6.
- The web address stays the same, so links you have already shared keep working.
- Step 2 and Step 3 keep the funnel’s current PDF and cover image. Leave them as they are, or choose a new PDF or image to replace them.
- The Created date on My Custom Funnels stays the day you first built the funnel.
Funnel Builder: Importing Funnels From A CSV File
Open it from Free Consumer Reports > CSV Import, or click Import CSV on My Custom Funnels. Each row in your file becomes one funnel.
- Click Download Sample to get funnel-import-sample.csv. It has the right column names and two example rows. Its example rows use the health and beauty niches. Click CSV Format Reference to open the column list on screen.
- Fill in one row per funnel in Google Sheets or Excel and save it as a .csv file.
- Click Choose CSV File and pick your file. Its name and size show with a Remove button.
- Click Upload & Validate. Nothing is created yet. The add-on checks every row.
- Under Review & Import you see how many rows are valid and how many errors there are. Each error names its row, for example “Row 3: Headline is empty.” Row numbers match your spreadsheet, with the header as row 1.
- If your file uses categories you do not have yet, you see New categories detected in this CSV. Click Create These Categories & Continue. They are created and the file is checked again.
- Click Import [number] Valid Rows. Rows with errors are left out. The rows go in a few at a time, and the progress bar shows how many are done.
- When it finishes you see Import Complete with how many funnels were created, how many were skipped because they already exist, and any that failed. Each skipped or failed row is listed with its spreadsheet row number and the reason. Click View All Funnels or Import Another CSV.
Good to know:
- Each PDF and cover image is downloaded to your site during the import, so big files take a while.
- Importing the same file again is safe. A row whose funnel already exists (same title in the same category) is skipped and listed as “already exists”, so you never get -2 copies.
- If an import stops part way, the funnels already saved stay. Upload the same file again and import: the saved rows are skipped and the rest are added.
- Files saved from Excel as “CSV UTF-8” work, as do plain CSV files and Google Sheets downloads.
- A checked file is kept for one hour. After that, click Upload & Validate again before you import.
Funnel Builder: CSV Columns And An Example Row
The first row must be these column names. Column order does not matter. Extra columns are ignored.
Required columns:
- title: the funnel title. The web address is made from it.
- category: a niche slug (beauty, dating, education, gaming, health, home, sweepstakes, tech) or its name, for example health or Health & Fitness, or the slug or name of one of your own categories. Letter case does not matter. A new name, like Pet Care, can be created for you during the import.
- headline: the squeeze page headline.
- cta_text: the button text.
- pdf_url: a direct link to the PDF. It is downloaded to your site during the import.
Optional columns:
- subheadline: the line under the headline.
- cover_image_url: a link to the cover image. It is downloaded to your Media Library and used as the cover.
- accent_color: a hex colour with the # sign, for example #667eea. Blank uses #667eea.
- affiliate_link: this funnel’s own Check Out This Resource link. Blank uses your Geo Smart Link.
- template: one of gradient, clean-card, bold-vibrant, minimal, dark-professional, modern-glass, neon-cyber, warm-sunset, corporate-blue. Blank uses gradient.
There are no CSV columns for the popup headline or the gradient colours. Imported funnels use the headline in the popup and the standard purple and blue gradient.
Header row:
title,category,headline,cta_text,pdf_url,subheadline,cover_image_url,accent_color,affiliate_link,template
Example row:
“Best Home Workout Gear Guide”,health,”FREE: Best Home Workout Gear Guide”,”Get Free Access”,”https://example.com/wp-content/uploads/home-workout-guide.pdf”,”What to buy, and what to skip”,”https://example.com/wp-content/uploads/home-workout-cover.png”,”#10b981″,””,”clean-card”
Put quotes around any value that has a comma in it. Save the file with commas, not semicolons. In Excel, “CSV UTF-8” and “CSV (Comma delimited)” both work. Google Sheets users can use File > Download > Comma Separated Values.
Funnel Builder: Managing Categories
Open it from Free Consumer Reports > Categories. Use it to add and manage your own categories and to style the 8 report niches. Categories group your funnels on the Showcase page and appear in the wizard’s Category list.
Add a new category:
- Type a Label (required), for example Pet Care.
- The Slug fills in by itself (pet-care). Lowercase letters, numbers and hyphens only. In a CSV you can use the slug or the label in the category column.
- Paste an Emoji if you want one.
- Pick a Badge Color.
- Click Add Category.
The All Categories table:
The table lists the 8 report niches, marked Built-in, and your own categories, marked Custom. Columns are Emoji, Label, Slug, Badge Color, Funnels (how many switched-on funnels use it), Type, Public URL and Actions.
- Change the emoji or colour right in the row, for a niche or for your own category. A Save button appears. Click it. The new look shows on your Showcase page.
- The niches cannot be deleted. Their Reset button puts back the original emoji and colour.
- Your own categories have Edit and Delete. Edit loads the category into the form at the top. Click Update Category, or Cancel Edit. The slug cannot be changed once a category exists.
- Delete opens a box called “Delete Category?”. Click Delete to remove it. A category that any funnel uses cannot be deleted.
- The Public URL is that category’s page on your Showcase site, for example yoursite.com/report-resources/category/pet-care/.
The report niches:
The 8 niches have these slugs: beauty, dating, education, gaming, health, home, sweepstakes, tech. They are always ready to use in the wizard and in CSV import, and their slugs cannot be used for a new category.
Funnel Builder: Report Funnels, Niches And Where Custom Funnels Appear
Your report funnels:
Nothing about them changes. They keep their pages, settings and stats. Your custom funnels are added alongside them. The 9 page templates for report funnels are part of the main plugin, on any funnel’s Edit page under Customization, with or without the add-on.
Where custom funnels appear:
- Squeeze page: yoursite.com/reports/your-funnel/ (or your own URL Prefix from Settings).
- Download page: yoursite.com/reports/your-funnel/download.html. Visitors land here after they opt in.
- Legal pages: privacy.html, terms.html and disclaimer.html in the same place, linked in the footer.
- The Funnels tab in the main plugin, with the report funnels, its on/off switch and its Edit page.
- The Showcase page, in its category, with its cover image.
- Files: wp-content/uploads/fcreports-assets/funnels/your-funnel/ on your server.
Niches and custom funnels:
Custom funnels follow the same niche rules as the report funnels. A funnel page opens when your licence unlocks its category. If your key covers every niche, all categories work, including your own. If your key covers only some niches, put your custom funnels in one of those niches.
Funnel Builder: Tips
- Choose the web address with care in the URL Slug box. It stays the same when you edit the funnel later.
- For the PDF, the easiest route is to upload it with Upload PDF. If you use a link, open it in a private browser window first. It should show or download the PDF straight away, with no sign-in or share page.
- In a CSV, use a niche slug or name such as health, tech or Health & Fitness, or one of your own categories.
- Importing the same CSV again is safe: rows already imported are skipped. If a big import stops part way, simply import the same file again.
- To change the text, PDF, cover, template or colours of a custom funnel, click Edit on My Custom Funnels. Its offer links and autoresponder are under Settings.
- Set your Geo Smart Links or Default Affiliate Link in Settings so every custom funnel’s download page shows your Check Out This Resource button.
Funnel Builder: Troubleshooting
Notice: the add-on “requires the Free Consumer Reports plugin”:
Install and activate the main plugin, then reload the page.
Notice: the add-on “is inactive: no licence on this site includes it”:
Click Add your Funnel Builder key in the notice and add the key in the License panel. Check you used the Funnel Builder key, not a report niche key. If the key is there but the notice stays, click Refresh License Info. If you or a developer edited the add-on’s files, it switches itself off: delete it and install a fresh copy from your members area.
The tab says Funnel Builder UPGRADE, or the menu items are missing:
The add-on is not active or not unlocked yet. Activate it under Plugins, then add your Funnel Builder key.
Diagnostics says “Installed, no licence on this site includes it”:
The add-on is installed but not unlocked yet. Add your Funnel Builder key in the License panel. When it is unlocked, the row says Active v1.0.4 and the tab bar shows Funnel Builder ACTIVE.
My custom funnel shows 404:
- Diagnostics shows “Permalinks: Plain”. Go to Settings > Permalinks, choose Post name and click Save Changes.
- The funnel is switched off. Its Status says Disabled. Switch it on in the Funnels tab.
- Its category is not unlocked by your licence. If your key covers only some niches, move the funnel into one of them by building it again in that niche.
- Still 404? Go to Settings > Permalinks and click Save Changes once more, even if Post name is already chosen.
Creating a category says “This slug conflicts with a built-in category.”:
The name turns into one of the 8 niche slugs, for example Health. That niche is already there to use. For a separate category, pick a different name, for example Health Tips.
Saving says “Could not create funnel directory.”:
WordPress cannot write to your uploads folder. On the Diagnostics tab, look at “uploads/fcreports-assets/” under Critical Plugin Files. If it says Missing or Not writable, ask your host to make wp-content/uploads writable.
Saving says “PDF download failed” or “PDF download returned HTTP 403”:
Your site could not fetch the PDF from that link. Use a direct, public link to the file, or upload the PDF in Step 2 instead. The same goes for “Cover image download failed”.
Saving says “The selected PDF attachment does not exist.”:
The file was removed from the Media Library. Go back to Step 2 and choose the PDF again.
Saving says “A PDF source (URL or uploaded file) is required.”:
Go back to Step 2 and choose a PDF or paste a link. When you edit a funnel, this only shows if the funnel has no PDF on file yet.
Any screen says “Security check failed.”:
The page was open a long time. Reload it and try again.
CSV says “Only CSV files are accepted.”:
Save the file as .csv, not .xlsx or .numbers.
CSV says “Missing required columns”:
Row 1 of the file must be the header row, with title, category, headline, cta_text and pdf_url spelled exactly like that. Files must use commas, not semicolons.
CSV says “CSV file is empty or has no headers.”:
The file has nothing in it. Check you picked the right file and that it was saved.
CSV row errors:
Fix the row in your file and click Upload & Validate again.
- “Title is empty.”, “Category is empty.”, “Headline is empty.”, “CTA text is empty.”, “PDF URL is empty.”: fill in that cell.
- “PDF URL is not a valid URL.”: the link must start with http:// or https://.
- “Accent color is not a valid hex color.”: use # and 3 to 8 hex digits, for example #10b981.
- “Template … is not valid.”: use one of the 9 template names exactly as listed.
CSV says “No validated CSV data found”:
A checked file is kept for one hour and is used up by an import. Click Upload & Validate again, then import.
Opt-ins from a custom funnel do not reach my list:
Custom funnels use the main plugin’s autoresponder settings. Check the Autoresponders tab and the funnel’s Edit page. On Diagnostics, “Default Autoresponder: Not set” or “Default List ID: Not set” means no default is chosen yet.
Diagnostics lists a caching plugin under Detected Potential Conflicts:
Exclude your funnel addresses (/reports/ by default) from that plugin’s cache, as the Diagnostics note says.
Diagnostics warns “Recommend 60s+ for asset downloads”:
Your Max Execution Time is short. Large CSV imports and PDF links may stop part way. Ask your host to raise it, or import in smaller batches.
A category cannot be deleted:
“This category is in use by one or more funnels and cannot be deleted.” means a funnel still uses it. Delete the funnels in that category first. The Funnels column only counts switched-on funnels, so a switched-off funnel can also be using it.
A CSV category shows under “New categories detected” but I meant an existing one:
The category column takes a slug (health) or a name (Health & Fitness), in any letter case. A name that matches neither, for example because of a typo, is treated as a new category. Fix it in your file and click Upload & Validate again, instead of creating it.
My funnel has no cover picture:
No cover image was added. Click Edit next to the funnel on My Custom Funnels, add a cover in Step 3 and click Update Funnel.