{"id":42,"date":"2026-05-08T06:15:55","date_gmt":"2026-05-08T06:15:55","guid":{"rendered":"https:\/\/docs.fasterthemes.com\/best-classifieds-wordpress-theme\/2026\/05\/08\/installation\/"},"modified":"2026-05-08T06:15:55","modified_gmt":"2026-05-08T06:15:55","slug":"installation","status":"publish","type":"post","link":"https:\/\/docs.fasterthemes.com\/best-classifieds-wordpress-theme\/2026\/05\/08\/installation\/","title":{"rendered":"Installation"},"content":{"rendered":"\n<h1 class=\"wp-block-heading\">Installation<\/h1>\n\n\n<p>This page walks through every install scenario for the Best Classifieds theme and Pro plugin \u2014 fresh install, migrating from another classifieds theme, multi-site, and licensing setup.<\/p>\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n<h2 class=\"wp-block-heading\">Requirements<\/h2>\n\n\n<figure class=\"wp-block-table\"><table>\n<thead><tr>\n<th>Component<\/th>\n<th>Minimum<\/th>\n<th>Recommended<\/th>\n<\/tr><\/thead><tbody>\n<tr>\n<td>WordPress<\/td>\n<td>6.0<\/td>\n<td>6.4 or newer<\/td>\n<\/tr>\n<tr>\n<td>PHP<\/td>\n<td>7.4<\/td>\n<td>8.1+<\/td>\n<\/tr>\n<tr>\n<td>MySQL \/ MariaDB<\/td>\n<td>5.6 \/ 10.1<\/td>\n<td>8.0 \/ 10.6<\/td>\n<\/tr>\n<tr>\n<td>HTTPS<\/td>\n<td>Required for Stripe\/Razorpay<\/td>\n<td>Always<\/td>\n<\/tr>\n<tr>\n<td>Memory limit<\/td>\n<td>128 MB<\/td>\n<td>256 MB<\/td>\n<\/tr>\n<tr>\n<td>Permalinks<\/td>\n<td>Pretty (<code>\/%postname%\/<\/code>)<\/td>\n<td>Pretty<\/td>\n<\/tr>\n<\/tbody><\/table><\/figure>\n\n\n<p>Best Classifieds is <strong>not block-theme-only<\/strong> \u2014 it works on classic and hybrid setups. It does not require WooCommerce, BuddyPress, or any other plugin to function.<\/p>\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n<h2 class=\"wp-block-heading\">Architecture overview<\/h2>\n\n\n<svg viewBox=\"0 0 720 280\" xmlns=\"http:\/\/www.w3.org\/2000\/svg\" style=\"max-width:100%;height:auto;display:block;margin:1rem auto;font-family:system-ui,sans-serif;\">\n  <rect x=\"20\" y=\"20\" width=\"200\" height=\"80\" rx=\"8\" fill=\"#FAFAF7\" stroke=\"#1E40AF\" stroke-width=\"1.5\"\/>\n  <text x=\"120\" y=\"50\" text-anchor=\"middle\" font-size=\"14\" font-weight=\"600\" fill=\"#1a1a1a\">Best Classifieds<\/text>\n  <text x=\"120\" y=\"68\" text-anchor=\"middle\" font-size=\"11\" fill=\"#5a6f84\">(free theme)<\/text>\n  <text x=\"120\" y=\"84\" text-anchor=\"middle\" font-size=\"10\" fill=\"#5a6f84\">listings, hero, footer, search<\/text>\n\n  <rect x=\"260\" y=\"20\" width=\"200\" height=\"80\" rx=\"8\" fill=\"#FAFAF7\" stroke=\"#1E40AF\" stroke-width=\"1.5\"\/>\n  <text x=\"360\" y=\"50\" text-anchor=\"middle\" font-size=\"14\" font-weight=\"600\" fill=\"#1a1a1a\">Best Classifieds Pro<\/text>\n  <text x=\"360\" y=\"68\" text-anchor=\"middle\" font-size=\"11\" fill=\"#5a6f84\">(licensed plugin)<\/text>\n  <text x=\"360\" y=\"84\" text-anchor=\"middle\" font-size=\"10\" fill=\"#5a6f84\">submission, payments, dashboard<\/text>\n\n  <rect x=\"500\" y=\"20\" width=\"200\" height=\"80\" rx=\"8\" fill=\"#FAFAF7\" stroke=\"#10b981\" stroke-width=\"1.5\"\/>\n  <text x=\"600\" y=\"50\" text-anchor=\"middle\" font-size=\"14\" font-weight=\"600\" fill=\"#1a1a1a\">WOW Feeder<\/text>\n  <text x=\"600\" y=\"68\" text-anchor=\"middle\" font-size=\"11\" fill=\"#5a6f84\">(optional)<\/text>\n  <text x=\"600\" y=\"84\" text-anchor=\"middle\" font-size=\"10\" fill=\"#5a6f84\">demo content + images<\/text>\n\n  <line x1=\"220\" y1=\"60\" x2=\"260\" y2=\"60\" stroke=\"#94a3b8\" stroke-width=\"1.5\" stroke-dasharray=\"4,3\"\/>\n  <line x1=\"460\" y1=\"60\" x2=\"500\" y2=\"60\" stroke=\"#94a3b8\" stroke-width=\"1.5\" stroke-dasharray=\"4,3\"\/>\n\n  <rect x=\"20\" y=\"160\" width=\"680\" height=\"80\" rx=\"8\" fill=\"#fff\" stroke=\"#cbd5e1\" stroke-width=\"1\"\/>\n  <text x=\"360\" y=\"190\" text-anchor=\"middle\" font-size=\"13\" font-weight=\"600\" fill=\"#1a1a1a\">WordPress core<\/text>\n  <text x=\"360\" y=\"212\" text-anchor=\"middle\" font-size=\"11\" fill=\"#5a6f84\">posts \u2192 become listings \u00b7 taxonomy \u2192 categories \u00b7 users \u2192 members \u00b7 postmeta \u2192 price\/location\/etc.<\/text>\n\n  <line x1=\"120\" y1=\"100\" x2=\"120\" y2=\"160\" stroke=\"#94a3b8\" stroke-width=\"1\"\/>\n  <line x1=\"360\" y1=\"100\" x2=\"360\" y2=\"160\" stroke=\"#94a3b8\" stroke-width=\"1\"\/>\n  <line x1=\"600\" y1=\"100\" x2=\"600\" y2=\"160\" stroke=\"#94a3b8\" stroke-width=\"1\"\/>\n<\/svg>\n\n\n<p>The free theme stores listings as <strong>standard WordPress posts<\/strong> under a &#8220;Listings&#8221; parent category. Pro adds richer fields, frontend submission, payments, and (optionally) a custom <code>listing<\/code> post type. WordPress remains in charge \u2014 your data is portable to any other theme if you ever move.<\/p>\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n<h2 class=\"wp-block-heading\">Installing the theme<\/h2>\n\n\n<h3 class=\"wp-block-heading\">Method A \u2014 WordPress admin upload (recommended)<\/h3>\n\n\n<ol class=\"wp-block-list\">\n<li><strong>Appearance \u2192 Themes \u2192 Add New \u2192 Upload Theme<\/strong><\/li>\n<li>Select <code>best-classifieds.zip<\/code><\/li>\n<li><strong>Install Now<\/strong> \u2192 <strong>Activate<\/strong><\/li>\n<\/ol>\n\n\n<h3 class=\"wp-block-heading\">Method B \u2014 SFTP<\/h3>\n\n\n<ol class=\"wp-block-list\">\n<li>Unzip <code>best-classifieds.zip<\/code> locally<\/li>\n<li>Upload the <code>best-classifieds\/<\/code> folder to <code>\/wp-content\/themes\/<\/code><\/li>\n<li><strong>Appearance \u2192 Themes<\/strong> \u2192 click Activate on Best Classifieds<\/li>\n<\/ol>\n\n\n<h3 class=\"wp-block-heading\">Method C \u2014 WP-CLI<\/h3>\n\n\n<pre class=\"wp-block-code\"><code>wp theme install \/path\/to\/best-classifieds.zip --activate<\/code><\/pre>\n\n\n<p>After activation, WordPress sets sensible defaults via <code>after_setup_theme<\/code>. You&#8217;ll see a dashboard notice prompting you to import demo content \u2014 that&#8217;s the WOW Feeder cue.<\/p>\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n<h2 class=\"wp-block-heading\">Installing Best Classifieds Pro <em>[Pro]<\/em><\/h2>\n\n\n<p>The Pro plugin extends the theme. Install order: <strong>theme first, then plugin<\/strong>. Activating Pro before the theme will surface a notice and refuse to bootstrap until the theme is active.<\/p>\n\n\n<ol class=\"wp-block-list\">\n<li><strong>Plugins \u2192 Add New \u2192 Upload Plugin<\/strong><\/li>\n<li>Select <code>best-classifieds-pro.zip<\/code><\/li>\n<li><strong>Install Now<\/strong> \u2192 <strong>Activate<\/strong><\/li>\n<li>You&#8217;ll be redirected to the Classifieds Pro dashboard with a &#8220;Activate your license&#8221; banner<\/li>\n<\/ol>\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n<h2 class=\"wp-block-heading\">License activation <em>[Pro]<\/em><\/h2>\n\n\n<p>Your license unlocks Pro features and enables auto-updates from FasterThemes.<\/p>\n\n\n<ol class=\"wp-block-list\">\n<li><strong>Appearance \u2192 BC Pro License<\/strong><\/li>\n<li>Paste the license key from your purchase email \u2014 it looks like <code>KB1Q7AQGSQRRUJE4TS0Q7JY1L<\/code><\/li>\n<li>Click <strong>Activate License<\/strong><\/li>\n<\/ol>\n\n\n<p>You should see:<\/p>\n\n\n<ul class=\"wp-block-list\">\n<li>A green <strong>Active<\/strong> pill<\/li>\n<li>The license key masked as <code>KB1Q\u2022\u2022\u2022\u2022\u2022\u2022\u2022\u2022JY1L<\/code><\/li>\n<li>An &#8220;Active Pro Features&#8221; grid with all unlocked capabilities listed<\/li>\n<li>&#8220;Last verified&#8221; showing seconds ago<\/li>\n<\/ul>\n\n\n<p>The license is tied to this exact site URL (<code>home_url()<\/code>). If you move to a new domain, <strong>deactivate<\/strong> on the old site first, then activate on the new one. Your single-site license allows unlimited domain changes \u2014 just one active install at a time.<\/p>\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\"><p><strong>License never reaches the server?<\/strong> Common cause: the host blocks outbound HTTPS to <code>fasterthemes.com<\/code>. Try a <code>curl -I https:\/\/fasterthemes.com<\/code> from SSH. Some shared hosts require allowlisting \u2014 see <a href=\".\/troubleshooting\/\">Troubleshooting<\/a> for the workaround.<\/p><\/blockquote>\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n<h2 class=\"wp-block-heading\">Multi-site notes<\/h2>\n\n\n<p>Best Classifieds works on WordPress Multisite as a <strong>per-site theme<\/strong>, not network-activated. The Pro license activates per-site. If you need a multi-site license, contact support \u2014 we provide a network license for agency customers.<\/p>\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n<h2 class=\"wp-block-heading\">Migrating from another classifieds theme<\/h2>\n\n\n<p>If you&#8217;re moving from Listify, ClassiPress, AdForest, etc., your existing listings can be migrated:<\/p>\n\n\n<figure class=\"wp-block-table\"><table>\n<thead><tr>\n<th>Source<\/th>\n<th>Target<\/th>\n<th>Migration approach<\/th>\n<\/tr><\/thead><tbody>\n<tr>\n<td>Custom post type (<code>job_listing<\/code>, <code>ad_listing<\/code>, etc.)<\/td>\n<td><code>post<\/code> (Best Classifieds default)<\/td>\n<td>Bulk-edit post type with WP-CLI: `wp post list &#8211;post_type=job_listing &#8211;format=ids <\/td>\n<td>xargs -I {} wp post update {} &#8211;post_type=post`<\/td>\n<\/tr>\n<tr>\n<td>Custom taxonomy (<code>job_category<\/code>)<\/td>\n<td><code>category<\/code><\/td>\n<td>Map terms manually under <strong>Posts \u2192 Categories<\/strong><\/td>\n<\/tr>\n<tr>\n<td>Listing meta (<code>_price<\/code>, <code>_location<\/code>)<\/td>\n<td><code>_bc_price<\/code>, <code>_bc_location<\/code><\/td>\n<td>SQL UPDATE or our migration helper (contact support)<\/td>\n<\/tr>\n<tr>\n<td>Featured image<\/td>\n<td>Featured image<\/td>\n<td>Already compatible<\/td>\n<\/tr>\n<\/tbody><\/table><\/figure>\n\n\n<p>For complex migrations with thousands of listings, we offer a paid migration service. Open a ticket via your account dashboard.<\/p>\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n<h2 class=\"wp-block-heading\">Where everything lives<\/h2>\n\n\n<pre class=\"wp-block-code\"><code>\/wp-content\/\n\u251c\u2500\u2500 themes\/\n\u2502   \u2514\u2500\u2500 best-classifieds\/        \u2014 the free theme\n\u2502       \u251c\u2500\u2500 assets\/css\/main.css   \u2014 main stylesheet\n\u2502       \u251c\u2500\u2500 assets\/js\/            \u2014 live-search, contact-reveal, navigation\n\u2502       \u251c\u2500\u2500 inc\/                  \u2014 template tags, customizer, widgets\n\u2502       \u2514\u2500\u2500 template-parts\/       \u2014 hero, categories, listings cards\n\u2514\u2500\u2500 plugins\/\n    \u251c\u2500\u2500 best-classifieds-pro\/             \u2014 main Pro plugin\n    \u2502   \u251c\u2500\u2500 includes\/                     \u2014 license, frontend, payments, dashboard\n    \u2502   \u2514\u2500\u2500 licenses\/                     \u2014 WPDigiPro adapter + update checker\n    \u2514\u2500\u2500 best-classifieds-wow-feeder\/      \u2014 demo content populator\n        \u2514\u2500\u2500 demo-content\/                 \u2014 48 listings, taxonomy, customizer JSON<\/code><\/pre>\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n<h2 class=\"wp-block-heading\">Next steps<\/h2>\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Set up the customizer:<\/strong> <a href=\".\/customizer\/\">Customizer Guide<\/a><\/li>\n<li><strong>Populate demo content:<\/strong> <a href=\".\/demo-import\/\">Demo Import<\/a><\/li>\n<li><strong>Configure payments:<\/strong> <a href=\".\/payment-gateways\/\">Payment Gateways<\/a><\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"<p>This page walks through every install scenario for the Best Classifieds theme and Pro plugin \u2014 fresh install, migrating from another classifieds theme, multi-site, and licensing setup.<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[2],"tags":[],"class_list":["post-42","post","type-post","status-publish","format-standard","hentry","category-getting-started"],"_links":{"self":[{"href":"https:\/\/docs.fasterthemes.com\/best-classifieds-wordpress-theme\/wp-json\/wp\/v2\/posts\/42","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/docs.fasterthemes.com\/best-classifieds-wordpress-theme\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/docs.fasterthemes.com\/best-classifieds-wordpress-theme\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/docs.fasterthemes.com\/best-classifieds-wordpress-theme\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/docs.fasterthemes.com\/best-classifieds-wordpress-theme\/wp-json\/wp\/v2\/comments?post=42"}],"version-history":[{"count":0,"href":"https:\/\/docs.fasterthemes.com\/best-classifieds-wordpress-theme\/wp-json\/wp\/v2\/posts\/42\/revisions"}],"wp:attachment":[{"href":"https:\/\/docs.fasterthemes.com\/best-classifieds-wordpress-theme\/wp-json\/wp\/v2\/media?parent=42"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/docs.fasterthemes.com\/best-classifieds-wordpress-theme\/wp-json\/wp\/v2\/categories?post=42"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/docs.fasterthemes.com\/best-classifieds-wordpress-theme\/wp-json\/wp\/v2\/tags?post=42"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}