docs: wordpress setup guide (#1873)

apps/formbricks-com/app/docs/wordpress/setup/page.mdx

@@ -0,0 +1,133 @@
+import Image from "next/image";
+
+import Img1 from "./1-wordpress-targeted-survey-on-website-free.webp";
+import Img2 from "./2-run-website-survey-wordpress-targeted-for-free.webp";
+import Img3 from "./3-wordpress-setup-survey-on-website-targeted-free-open-source.webp";
+import Img4 from "./4-wordpress-website-survey-target-visitor-free.webp";
+import Img5 from "./step-4-copy-to-wordpress-for-free-targeted-survey.webp";
+import Img6 from "./6-targeted-survey-on-wordpress-website-for-free.webp";
+import Img7 from "./7-wordpress-free-hotjar-survey-open-source-website-survey-hotjar.webp";
+
+export const metadata = {
+  title: "Run targeted surveys on your WordPress page",
+  description:
+    "Target specific visitors with a survey on your WordPress page using Formbricks for free. Show survey on specific page or on button click.",
+};
+
+#### WordPress
+
+# Connect Formbricks with your WordPress page
+
+If you want to run a targeted survey on your WordPress website, Formbricks is the way to go! With our generous free plan and open source tech, you get everything you need to get started and keep full control over your data.
+
+## TLDR
+
+1. Install the Formbricks WordPress plugin
+2. Create a [free Formbricks account](https://app.formbricks.com/auth/signup)
+3. Find and copy the `environment id`
+4. Copy the environment id into the right field in the plugin settings
+5. Create survey on trigger “New Session” to test it
+
+## Step 1: Install the Formbricks WordPress plugin
+
+As long as the Formbricks plugin is in review, please download it from our [GitHub repository directly.](https://github.com/formbricks/wordpress)
+
+<Image
+  src={Img1}
+  alt="Run targeted website survye on any WordPress site"
+  quality="100"
+  className="max-w-full rounded-lg sm:max-w-3xl"
+/>
+
+## Step 2: Create a Formbricks Account
+
+This is super straight forward: Go to [app.formbricks.com/auth/signup](https://app.formbricks.com/auth/signup), create the account, verify your email and you’re in!
+
+When you see this screen, you’re there:
+
+<Image
+  src={Img2}
+  alt="Free HotJar survey alternative open source"
+  quality="100"
+  className="max-w-full rounded-lg sm:max-w-3xl"
+/>
+
+## Step 3: Find and copy the environmentId
+
+Go to Settings > Setup Checklist where you’ll find your environmentId:
+
+<Image
+  src={Img3}
+  alt="Run targeted surveys for free on WordPress pages"
+  quality="100"
+  className="max-w-full rounded-lg sm:max-w-3xl"
+/>
+
+## Step 4: Copy the environmentId to the WordPress Plugin Settings
+
+In your WordPress instance, go to the Formbricks Plugin settings and copy the environmentId in the correct field:
+
+<Image
+  src={Img5}
+  alt="Free and open source HotJar survey on WordPress page"
+  quality="100"
+  className="max-w-full rounded-lg sm:max-w-3xl"
+/>
+
+Then click the button at the bottom to see if the connection worked.
+
+<Note>If you don’t use our Cloud, you also have to update the API Host</Note>
+
+Great!
+
+## Step 5: Create survey on trigger “New Session”
+
+Now that all is setup, we create a survey to display an example survey. Pick any template here:
+
+<Image
+  src={Img2}
+  alt="Free HotJar survey alternative open source"
+  quality="100"
+  className="max-w-full rounded-lg sm:max-w-3xl"
+/>
+
+Keep the content for now, click on the Settings tab:
+
+<Image
+  src={Img4}
+  alt="Free and open source HotJar survey on WordPress page"
+  quality="100"
+  className="max-w-full rounded-lg sm:max-w-3xl"
+/>
+
+
+
+Here we do three things:
+
+1. Change survey type to “In-App Survey”
+2. Select trigger “New Session”
+3. Publish
+
+<Image
+  src={Img6}
+  alt="Open Source survey on targeted website wordpress"
+  quality="100"
+  className="max-w-full rounded-lg sm:max-w-3xl"
+/>
+
+When you see this page, you did it!
+
+<Image
+  src={Img7}
+  alt="Run free an open source targeted survey on any page"
+  quality="100"
+  className="max-w-full rounded-lg sm:max-w-3xl"
+/>
+
+## Step 6: Reload your page to check out your survey 🤓
+
+You did it! Reload the WordPress page and your survey should appear!
+
+
+## Doesn't work?
+Join our [Discord to get help 🤓](https://formbricks.com/discord)

apps/formbricks-com/components/docs/Navigation.tsx

@@ -287,6 +287,15 @@ export const navigation: Array<NavGroup> = [
       { title: "Webhooks", href: "/docs/api/management/webhooks" },
     ],
   },
+  {
+    title: "WordPress",
+    links: [
+      { title: "Setup", href: "/docs/wordpress/setup" },
+      /*       { title: "Styling", href: "/docs/wordpress/styling" },
+      { title: "Targeting", href: "/docs/wordpress/targeting" },
+      { title: "Exit Intent", href: "/docs/wordpress/exit-intent" }, */
+    ],
+  },
 ];
 
 export function Navigation(props: React.ComponentPropsWithoutRef<"nav">) {