Shada for Strapi

Posted on Nov 16, 2021 • Originally published at strapi.io

How to Build a Forum App with NextJs and Strapi CMS

#nextjs #cms #tutorial #application

While programming, programmers encounter various challenges, which make them solicit help with solving these problems. Forums provide a tech community of enthusiasts who can assist with these problems. We will be building a forum site with NextJs on the Front-end and Strapi for content management

Goals

This tutorial will cover building a forum website and providing user authentication and authorization on the site.

Prerequisite

To fully grasp this tutorial, you need:

Node.js installed
Knowledge of NextJs

What is Strapi?

Strapi is an open-source headless CMS built on Node.js. Strapi enables developers to be able to create and manage the contents of their applications. Strapi provides users with an admin panel that is used to manage the user's content. Content can be created as in a traditional database; with tables. What's more? Strapi provides functionality to integrate APIs and allows collaborative access to content to enable multiple users to access and manage stored data.

Strapi setup

To set up our Strapi back-end, we will first create a directory for our project:

    mkdir forumapp

This creates a folder for our project strapi-forum. Next, we move into this folder:

    cd forumapp

Then we install Strapi:

    npm create strapi-app forum-backend --quickstart

The command above sets up Strapi for our app with all dependencies required. Here forum-backend is the name of our project folder. The --quickstart option sets up Strapi with a sqlite database.

Above, after the dependencies have been installed, it proceeds to set up the admin UI.

Once the process is complete, it runs strapi develop and opens up a URL in your browser.

Here, it opens up our administrator panel on localhost. If you open up your browser to the URL, you will get a form.

Fill out your details in the form and click on "Let's start." It will sign you in and navigate you to the dashboard.

Collection and Field Setup

This section will create our CollectionCollection to contain the post and comments for our forum application.

Click on the "Create your first content-type" button. It opens up a page to create our content. There is a modal where you can enter the name of your CollectionCollection.

Then, click on "Continue". Another modal appears where you set the field for your collection type. Click on "Text," then add the text fields.

Add "Title" in the text field and click on "Add another field". Repeat the process for two additional fields, but we will use "Rich text" instead this time.

We now have three fields: the title, answers, and questions for our forum posts. Click on the "Save" button. Now, in the Collection type sidebar, we see the "Strapi forums" collection. Click on it, then click on the "Add new Strapi Forums" button:

You'll get a page where you can create an entry for the Forum app. Enter a title in the Title field, answer any question, click "Save" then "Publish".

The new entry will be added to the "Strapi Forums" collection.

To enable our app to allow access to content without authorization, you must go to Settings then Roles.

Click on “Public”.

Click on Select all then Save.

Fetching the Collection

You can fetch the data from the CollectionCollection with an API tester. Enter the URL: http://localhost:1337/strapi-forums. Send a request, and you'll get the response from Strapi:

Building our front-end

We will build the front-end of our forum application with Next.js. Next.js is an open-source framework built on Node.js to allow React applications to be rendered on the server-side.

To install Next.js

    npx create-next-app forum

The above command installs the Next.js framework in a project folder forum for us. Our finished app will have two pages: one to display the forum and the other to post new questions. The images below show what our app will look like:

The display forum page:

Post a new question page:

In the forum project folder, our app structure will look like this:

┣ 📂pages
 ┃ ┣ 📂api
 ┃ ┃ ┗ 📜hello.js
 ┃ ┣ 📂Components
 ┃ ┃ ┣ 📜Displayforum.js
 ┃ ┃ ┗ 📜Uploadforum.js
 ┃ ┣ 📜index.js
 ┃ ┣ 📜upload.js
 ┃ ┗ 📜_app.js
 ┣ 📂public
 ┃ ┣ 📜favicon.ico
 ┃ ┗ 📜vercel.svg
 ┣ 📂styles
 ┃ ┣ 📜globals.css
 ┃ ┗ 📜Home.module.css

Here, our index.js file is our display form page, and it makes use of the component Displayforum.js while the upload.js file serves as our page for posting new questions. It contains the component Uploadforum.js. All our styles are in Home.module.css.

In Index.js we have the following codes:

    import styles from "../styles/Home.module.css";
    import Displayforum from "./Components/Displayforum";
    export default function Home() {
      return (
        <div className={styles.container}>
          <Displayforum />
        </div>
      );
    }

Here we have added the Displayforum component to our page. In Displayforum.js, we have:

    import React, { useState } from "react";
    import style from "../../styles/Home.module.css";
    import Link from "next/link";
    function Displayforum() {
      const [show, setShow] = useState(false);
      return (
        <div>
          <div className={style.topcont}>
            <h1 className={style.heading}>Display forum</h1>
            <div>
              <Link href="/upload">
                <button>Ask a question</button>
              </Link>
              <button>Login</button>
            </div>
          </div>
          <h2 className={style.subheading}>Questions</h2>
          <div className={style.userinfo}>
            <p>Posted By: Victory Tuduo</p>
          </div>
          <div className={style.questioncont}>
            <p className={style.question}>Description of the Question</p>
          </div>
          <div className={style.answercont}>
            <h2 className={style.subheading}>Answers</h2>
            <div className={style.inputanswer}>
              <form>
                <textarea type="text" placeholder="Enter your answer" rows="5" />
                <button>Post</button>
              </form>
            </div>
            <button className={style.showanswer} onClick={() => setShow(!show)}>
              {show ? "Hide Answers" : "Show Answers"}
            </button>
            {show ? (
              <div className={style.answers}>
                <div className={style.eachanswer}>
                  <p className={style.username}>Miracle</p>
                  <p className={style.answertext}>Try doing it Like this</p>
                </div>
              </div>
            ) : null}
          </div>
        </div>
      );
    }
    export default Displayforum;

This component handles the layout of our display forum page. We also have a button here that directs the user to the page to upload new questions.

Meanwhile, in upload.js we have the following:

    import React from "react";
    import Uploadforum from "./Components/Uploadforum";
    function upload() {
      return (
        <div>
          <Uploadforum />
        </div>
      );
    }
    export default upload;

Here, we simply added an import for the Uploadforum component into our page. In Uploadforum.js file we have a simple form to create new questions:

    import React from "react";
    import style from "../../styles/Home.module.css";
    import Link from "next/Link";
    function Uploadforum() {
      return (
        <div className={style.uploadpage}>
          <div className={style.topcont}>
            <h1>Ask a question</h1>
            <Link href="/">
              <button>Forum</button>
            </Link>
          </div>
          <div className={style.formcont}>
            <form className={style.uploadform}>
              <input type="text" placeholder="Enter your title" maxLength="74" />
              <textarea type="text" placeholder="Enter your description" rows="8" />
              <button>Submit Question</button>
            </form>
          </div>
        </div>
      );
    }
    export default Uploadforum;

Finally, we have the following styles in Home.module.css

    .container {
      min-height: 100vh;
      padding: 0 0.5rem;
      height: 100vh;
      font-family: monospace;
    }
    /* display forum page */
    .topcont {
      display: flex;
      justify-content: space-between;
      align-items: center;
      padding: 5px 8px;
    }
    .topcont button,
    .inputanswer button,
    .formcont button,
    .showanswer {
      border: none;
      color: #fff;
      background: dodgerblue;
      border-radius: 8px;
      padding: 10px 15px;
      outline: none;
      margin: 8px;
    }
    .topcont button:hover {
      cursor: pointer;
      transform: scale(1.2);
    }
    .heading {
      font-weight: bold;
    }
    .subheading {
      font-weight: 500;
      text-transform: uppercase;
    }
    .userinfo {
      font-size: 18px;
      font-weight: 600;
    }
    .questioncont {
      min-height: 300px;
      padding: 15px 14px;
      box-shadow: 12px 12px 36px rgba(0, 0, 0, 0.12);
    }
    .answercont {
      min-height: 300px;
      padding: 5px 3px 5px 15px;
    }
    .answers {
      height: 300px;
      overflow-x: scroll;
    }
    .inputanswer {
      margin-bottom: 8px;
    }
    .inputanswer textarea {
      width: 100%;
      resize: none;
      padding: 5px 8px;
    }
    .showanswer {
      border: 1px solid dodgerblue;
      background: #fff;
      color: dodgerblue;
      transition: 0.4s ease-in-out;
    }
    .showanswer:hover {
      background: dodgerblue;
      color: #fff;
    }
    .eachanswer {
      border-radius: 15px;
      background: #e7e7e7;
      padding: 8px 15px;
      margin-bottom: 10px;
    }
    .username {
      font-weight: bold;
      text-transform: uppercase;
    }
    .answertext {
      font-family: Montserrat;
      font-size: 14px;
      font-weight: 500;
    }
    /* upload a question page */
    .uploadpage {
      min-height: 100vh;
    }
    .formcont {
      min-width: 100vw;
      display: flex;
      justify-content: center;
      align-items: center;
    }
    .uploadform {
      display: flex;
      flex-direction: column;
      min-width: 500px;
      padding-top: 10px;
    }
    .uploadform input,
    .uploadform textarea {
      resize: none;
      width: 100%;
      margin: 8px;
      padding: 5px;
    }

All of this makes up the layout of our pages.

Getting data from Strapi:

Setting up our Fetch Request

In this section, we will fetch our data from Strapi and display it in our app. We will be using Axios to perform our fetch operations.

We will install this via CLI:

    npm install axios

Create a file index.js in the API folder. Here, we will set up our fetch request:

    import axios from "axios";
    const url = "http://localhost:1337/strapi-forums";
    export const readForum = () => axios.get(url);
    export const createQuestion = (newQuestion) => axios.post(url, newQuestion);

Above, we added import for axios, the URL to fetch our data, and exported functions to read and create data from our forum.

We’ll import these functions into our app in our index.js file:

    import { readForum, createQuestion } from "./api";

Fetching Data from Strapi

We will fetch the data from Strapi in our index.js file and pass it to Displayforum.js component to display it:

    import { react, useState, useEffect } from "react";
    ...
    const [question, setQuestions] = useState({});
      const [response, setResponse] = useState([]);
      useEffect(() => {
        const fetchData = async () => {
          const result = await readForum();
          setResponse(result.data);
        };
        fetchData();
      }, []);

Here, we fetched our data from Strapi and assigned it to response with the React useState hook. We have a useEffect function that makes the request when our component mounts.

Now, we pass this response down to our Displayforum component.

    <Displayforum response={response} />

Displaying Data from Strap

To display our data in our Displayforum.js file, we will map our responses and render our components. Before we do this, we will create two additional text fields in our Strapi CollectionCollection: Username and Answername.

Back in our Displayforum component we will proceed with displaying our data:

    ...
    function Displayforum({ response }) {
    ...
      {response.map((response, index) => (
      <div key={index}>
      <div className={style.userinfo}>
      ...
       <p className={style.answertext}>Try doing it Like this</p>
              </div>
            </div>
          ) : null}
        </div>
      </div>
      ))}

Here, we wrapped up our components to map through response and display this component as many times as the number of responses. To display our Strapi data, we simply reference it. We can get our Username with this code:

    response.Username

We can now add this to our component and display it:

    <p>Posted By: {response.Username}</p>
    ...
    <p className={style.question}>{response.Questions}</p>
    ...
    <p className={style.username}>{response.Answername}</p>
    <p className={style.answertext}>{response.Answers}</p>

We have successfully added the data from our CollectionCollection to our front-end to view this in the browser. Run the following command in the CLI:

    npm run dev

In your browser, you will have an output similar to the image below:

After this, we will add functionality to add new questions to Strapi.

Adding data to Strapi

In our Uploadforum.js file, we will add functionality to upload the contents of the form to Strapi. First, we will create two state variables to store the text from our inputs.

    import { React, useState } from "react";
    ...
    const [name, setName] = useState("");
    const [description, setDescription] = useState("");

Then we set these variables to the value of our form input.

    <input
                type="text"
                placeholder="Enter your title"
                maxLength="74"
                value={name}
                onChange={(e) => setName(e.target.value)}
              />
              <textarea
                type="text"
                placeholder="Enter your description"
                rows="8"
                value={description}
                onChange={(e) => setDescription(e.target.value)}
              />

Also we will a function to send these variables when we click our button.

    <button onClick={() => sendData()}>Submit Question</button>

We can create the sendData function above our return.

    const sendData = () => {
      };

For our create functionality we will import the createQuestion function we defined in our api folder.

    import { createQuestion } from "../api";

Then we pass in our data to this function.

    const sendData = () => {
        const newQuestion = {
          Title: name,
          Questions: description,
        };
        createQuestion(newQuestion);
      };

We can now upload new questions to our Strapi collection. We will add the Username when we cover user authentication.

Next up, we will add functionality to answer questions in our Displayforum component.

Adding Functionality to Answer Questions

Since we set a text field for our answers in our collection, it can only take in one value. To have multiple answers for a question, we will delete the Answers field and create another field for our Answers of type json.

With that done, here is an example of what a response from our API would look like:

To display our answers, we will map through Answers:

     {response.Answers.map((answers, i) => (
                      <div className={style.eachanswer} key={i}>
                        <p className={style.username}>{response.Answername}</p>
                        <p className={style.answertext}>{answers}</p>
                      </div>
                    ))}

Now in our browser, if we add more answers to our JSON collection, we can see them displayed on our page.

Adding New Answers

We will repeat the same method as we did with our Upload Question functionality for the add answer functionality, but with a minor difference. In your Displayforum component, add the following code:

    import axios from "axios";
    ...
    const [answer, setAnswer] = useState("")
    const [id, setId] = useState("");
    const [a, formerArray] = useState([]);

We will store the input from the textarea in answer. We will use the id variable to reference the collection we want to add the answer to.

Then in our form textarea:

     <textarea
                      type="text"
                      placeholder="Enter your answer"
                      rows="5"
                      value={answer}
                      onChange={(e) => setAnswer(e.target.value)}
                    />
     <button onClick={() => {
                      setId(response.id);
                      formerArray(response.Answers);
                      submitAnswer()
                    }}>Post</button>

Then in the submitAnswer function:

    const submitAnswer = () => {
        try {
          axios.put(`http://localhost:1337/forums/${id}`, {
            Answers: [...a, answer],
          });
        } catch (error) {
          console.log(error);
        }
      };

With this, we can now add answers through our form to our collection.

User Authentication with NextAuth

This section will use Nextauth, a NextJs package for authentication, to implement Google login for our application. We will also set up protected routes so that only authenticated users can create questions and view them.

To install next-auth:

    npm i next-auth

For our authentication, we will make use of JWT token . JWT is a standard used to create access tokens for an application.

We will create a file to handle user authentication. To do this, create a folder named auth in your api folder and within it, create a file [...nextauth].js with the following code in it:

    import NextAuth from "next-auth";
    import GoogleProvider from 'next-auth/providers/google'

    export default NextAuth({
      providers: [
        GoogleProvider({
          clientId: process.env.GOOGLE_CLIENT_ID,
          clientSecret: process.env.GOOGLE_CLIENT_SECRET,
          authorizationUrl: 'https://accounts.google.com/o/oauth2/v2/auth?prompt=consent&access_type=offline&response_type=code',
        })
      ],
      jwt: {
        encryption: true
      },
      secret: process.env.secret,
      callbacks: {
        async jwt(token, account) {
          if (account ?.accessToken) {
            token.accessToken = account.accessToken
          }
          return token;
        },
        redirect: async (url, _baseUrl)=>{
          if (url === '/check') {
            return Promise.resolve('/')
          }
          return  Promise.resolve('/')
        }
    }
    });

The code above sets up our Google Authentication for our app. To use it, we need to wrap up our application in _app.js with the Google Provider component:

    ...
    import {Provider} from 'next-auth/client'
    function MyApp({ Component, pageProps }) {
      return (
        <Provider session={pageProps.session}>
          <Component {...pageProps} />
        </Provider>
      );
    }
    export default MyApp;

Next, we will modify our Displayforum component in to return to our component if the user is authenticated, else it returns a button that leads to an authentication page:

    import {signIn, signOut, useSession} from 'next-auth/client'
    ...
    const [session, loadingSession] = useSession();

We will use useSession to know if our user has been authorized.

    if (loadingSession) {
        <>
          <p>logging in</p>
        </>;
      }
    return(
    ...

The above code simply returns “logging in” if loadingSession is true. If there is session, we will return the rest of the component and if there is no session we will render a button to sign in to access the app.

    return(
    <div>
    {!session && (
            <>
              <h1>Sign in to access forum</h1>
              <button onClick={() => signIn()}>Sign In</button>
            </>
          )}
    {session && (
     <>
     {/*rest of our app*/}
     </>
     )}
    </div>

We will also set our button to Sign out:

    ...
    <Link href="/upload">
      <button>Ask a question</button>
    </Link>
    <button onClick={() => signOut()}>Signout</button>
    ...

To make use of Google authentication in our app, we will require access credentials from Google Cloud console. To get this, navigate in your browser to Google Cloud.

Click on OAuth Client ID and Fill out the fields on the new page that opens.

Finally, set the redirect URL to: http://localhost/api/auth/callback/google

To use the credentials in the […nextauth].js file, you can create a .env file and set up your environmental variables:

    GOOGLE_CLIENT_ID: id
    GOOGLE_CLIENT_SECRET: secret
    secret: any string

Next, we will set up our Uploadforum.js component on our upload page as a protected route so that unauthorized users can’t access the route. To do this, in upload.js add the following code:

    import { getSession, useSession } from 'next-auth/client'

Then at the bottom:

    export async function getServerSideProps(context) {
      const session = await getSession(context);
      if (!session) {
        context.res.writeHead(302, { Location: '/' });
        context.res.end();
        return {};
      }
      return {
        props: {
          user: session.user,
        }
      }
    }
    export default Upload;

Now, if you run the app with npm run dev in CLI, we have Google authentication implemented. Also we can’t access the /upload path without logging in.

Adding User name to Collection

Now that we have added authentication to our app, we can add the username received from the Google Login as the Answername field when we answer a question:

    ...
     axios.put(`http://localhost:1337/forums/${id}`, {
            Answers: [...a, answer],
            Answername: session.user.name,
          });

Now, if I add a new answer to the form:

When I click on the Post button, I get:

The answer has been added and the Answername field has been set to my user.name form our session.

Finally, we will also add the username when posting a question to our collection. We will do this in our upload.js file:

     const [session, loadingSession] = useSession();

Then we pass the value of session to our Uploadforum Component:

    <Uploadforum session={session} />

We can now use session data in our Uploadforum component:

    function Uploadforum({session}) {
    ...
     const newQuestion = {
          Title: name,
          Questions: description,
          Answers: [""],
          Username: session.user.name,
        };

Any new questions added now take the Username field to be the username received from session.

If we add new answers, since the Answername is a field, it overwrites the previous data and all the answers use the same name. To fix this, we will simply modify our Answers field of type JSON to contain both the answers and the username of the person providing the answers.

Then, we can get this data and display it in our Displayforum component:

     <div className={style.answers}>
                        {response.Answers.map((answers, i) => (
                          <div className={style.eachanswer} key={i}>
                            <p className={style.username}>{answers[0]}</p>
                            <p className={style.answertext}>{answers[1]}</p>
                          </div>
                        ))}

answer[0] is the name of the user, while answers[1] is the answer.

Finally, we will modify the code to add new answers:

    ...
     axios.put(`http://localhost:1337/forums/${id}`, {
            Answers: [...a, [session.user.name, answer]],
          });
        } catch (error) {
          console.log(error);

We can now add new answers to our questions without overwriting previous data.

When I click on post I get a new answer:

Conclusion

We have come to the end of this tutorial. In this tutorial, we learned how to use Strapi CMS and connect it to NextJ's front-end. In this process, we built a forum site and implemented user authentication and authorization on it.