ChawkBazar Documentation
WelcomeTech We Have UsedGetting Started
Available Scripts & Command
How Can I use this app
Demo Deploy
Features
Settings
Payment
SEO and Analytics
API
Multilingual & Translation
OTP (Mobile Number Verification)Email ConfigurationEmail VerificationSocial LoginSubscribeFAQ PageContactTerms and conditions
Third-party Integrations
Deployment
Back-End Integration
Upgrade
Customizations
FAQHow to change the default layout?Why showing client_id error while Google social loginHow to configure Stripe payment gateway?Why am I facing "You may need an appropriate loader to handle this file type" during running shop rest?I am changing schema files but changes is not workingChanging .env files but not getting the changesChanging route but not getting the changes.I have set STRIPE_API_KEY in .env but still getting error.Can I use it with my existing laravel?Why am I getting Access denied for user ?Why am I getting permission issue during deployment?Why am I getting "The GET method is not supported for this route. Supported methods: HEAD"?I am getting "Cannot use 'Mixed' as class name as it is reserved" after access graphql endpoint.How to resolve the Load More Infinity loading issue?I'm trying to upload images, but the images are not displayed on the frontend?How to resolve the 502 Bad Gateway error for frontend/admin?How to resolve javascript heap out of memory issue?Image upload throw Internal Server Error; how to resolve that?Sometimes my server shutdown or halts automatically. After restart, it works fine again; how to resolve that?S3 uploading doesn't work after adding credentials to .env; how to resolve that?How to rebuild the project?How to increase upload size?How to resolve docker: invalid reference format: repository name must be lowercase. ?How to remove the existing payment gateway?Why checkout Place Order button is disabled?How do I log in to the admin panel as the main administrator?How to disable product popup view and redirect to a single product page?SupportChangelogs

FAQ:

How to change the default layout?

Please go to,

chawkbazar-laravel/shop/src/pages

And delete or change the name of index.tsx

Then rename your specific demo.tsx to index.tsx

After that, make sure you rebuild your project to run in production.

Why showing client_id error while Google social login

Ans: Go to .env file and change the variables from GOOGLE_ID= to GOOGLE_CLIENT_ID= and GOOGLE_SECRET= toGOOGLE_CLIENT_SECRET=. Make this changes in the .env file of chawkbazar-api and shop directory. ClientID_error.png

How to configure Stripe payment gateway?

To configure Stripe payment gateway,

  1. At first, create a developer account from stripe developer dashboard (https://dashboard.stripe.com/)
  2. log in to that account
  3. Then go to the Developer -> API Keys section and on that section create an API key. After creating, you'll get one Secret key and one Publishable key.StripeDev.png
  4. Then copy Secret key to your chawkbazar api->.env

SetStripeAPI.png

  1. And similarly, add Publishable key to your frontend/shop/.env

FrontStripe.png

After configuration, make sure you rebuild your project using this command,

For REST API

yarn build:shop-rest
yarn build:admin-rest

Why am I facing "You may need an appropriate loader to handle this file type" during running shop rest?

Ans: Please run yarn clean then yarn then run yarn dev:shop-rest

I am changing schema files but changes is not working

Your changes might not work because schema is cached. SO you might need to clear schema cache using the below command php artisan lighthouse:clear-cache.

Changing .env files but not getting the changes

Run Below command php artisan optimize:clear

Changing route but not getting the changes.

Run php artisan optimize:clear or php artisan route:clear

I have set STRIPE_API_KEY in .env but still getting error.

In some cases STRIPE_API_KEY value can't read from .env in those cases you have to put the key in the config file directly in api/packages/marvel/src/Config/laravel-omnipay.php

  1. Getting error on forget password email sending Make sure you have run the php artisan marvel:install commands successfully and copied the necessary email templates to your resources folder. You can also do it by php artisan marvel:copy-files command.

    NB: This same issue can occur during order creation.

Can I use it with my existing laravel?

Yes, you can. Follow the below steps.

  • Make sure you are using laravel 8.
  • Copy api/packages folder from the downloaded files into your laravel root folder.
  • Put below code in your laravel composer.json file into require section.
"ignited/laravel-omnipay": "dev-master",
"omnipay/common": "dev-master",
"omnipay/stripe": "dev-master",
"chawkbazar/shop": "dev-master"
  • Put below code in bottom of your composer.json. If you already have an repositories section then put code inside repositories to your existing repositories
"repositories": {
"chawkbazar/shop": {
"type": "path",
"url": "packages/marvel"
},
"ignited/laravel-omnipay": {
"type": "path",
"url": "packages/laravel-omnipay"
},
"omnipay/common": {
"type": "path",
"url": "packages/omnipay-common"
},
"omnipay/stripe": {
"type": "path",
"url": "packages/omnipay-stripe"
}
}
  • Now run composer install
  • Copy necessary env variables from .env.example to you env file.
  • Run php artisan marvel:install and follow necessary steps.
  • To run server php artisan serve
  • For image upload to work properly you need to run php artisan storage:link.

Why am I getting Access denied for user?

navigate to api then run ./vendor/bin/php down -v. It will delete any of your existing mysql volumes. Now run ./vendor/bin/php up -d on same directory or run bash install.sh on root directory

Why am I getting permission issue during deployment?

Run below commands for fixing permission issue in your laravel app during deployment

sudo chown -R $USER:www-data storage
sudo chown -R $USER:www-data bootstrap/cache
sudo chown -R www-data:www-data storage
sudo chown -R www-data:www-data bootstrap/cache

Why am I getting "The GET method is not supported for this route. Supported methods: HEAD"?

Run php artisan optimize:clear

I am getting "Cannot use 'Mixed' as class name as it is reserved" after access graphql endpoint.

You are using the application in PHP 8. Downgrade it to PHP 7.4. Mixed is a reserved word in PHP 8.

How to resolve the Load More Infinity loading issue?

If you click on the Load More button and the button is spinning continuously, then check API request from the network tab. If it is HTTP and your API is hosted on HTTPS, then open,

/Users/tareqmahmud/tmbox/tmserver/larabox/work/redq/laravel-ecommerce/api/app/Providers/AppServiceProvider.php

And add this code to boot method,

if (!\App::environment('local')) {
$this->app['request']->server->set('HTTPS', true);
}

I'm trying to upload images, but the images are not displayed on the frontend?

We support two types of file uploads; one is local, and another is AWS S3.

Both uploading systems follow this procedure,

API

At first, add your API URL to your chawkbazar-api -> .env.

APIDomain.png

If you're using windows and your API is running with ports like localhost:8000 or 127.0.0.1:8000, then make sure you add the domain with port to APP_URL. Like this API_URL=http://localhost:8000

After that, clear your API cache by using this command from the chawkbazar-api folder,

php artisan optimize:clear

Then link the storage system by using this command,

php artisan storage:link

If you're using AWS S3, then update MEDIA_DISK=s3 and add all AWS_ credentials

For AWS s3, make sure your properly setup permission of the bucket with ACL enable by follow this link -> https://stackoverflow.com/a/70603995/2158023

aws_s3_permissions

Admin

Then add your domain to your chawkbazar-laravel -> admin -> rest -> next.config.js

AddYourDomain.png

If you're using AWS S3, then also add your root S3 domain like this, S3Domain.png

Shop

Similarly, add your domain to your chawkbazar-laravel -> shop -> next.config.js

AddYourDomain.png

If you're using AWS S3, then also add your root S3 domain like this, S3Domain.png

Build Frontend,

If you run in dev mode, then re-run will affect your update. But if you're running as a production mode, then you've to rebuild the project and re-run again. Otherwise, image upload will not work.

https://chawkbazar-laravel-doc.vercel.app/vps-server#build-project

After building the project, replace your server shop and admin folder using this rebuild folder and re-run the app using this command,

pm2 restart all

How to resolve the 502 Bad Gateway error for frontend/admin?

There can be several reasons that throw 502 errors for the frontend in the production server.

Reason 1:

On your Nginx file, a specific port is set for shop or the admin, so when you run the script as a PM2` instance, the script has to be run that specific port; otherwise, your domain/subdomain will throw a 502 error.

PORT:

3003 -> Shop Rest
3002 -> Admin Rest

To check that at the first stop the PM2 instance by this command,

pm2 stop 'all'

then go to the chawkbazar folder from your server and try to run the script using yarn and check which port it is running,

Rest:

yarn start:admin-rest
yarn shop-rest

And, check if the port matched with the Nginx port or not? If not matched, then change the port to Nginx config.

Reason 2:

To check that at the first stop the PM2 instance by this command,

pm2 stop 'all'

then go to the chawkbazar folder from your server and try to run the script using yarn and check which port it is running,

Rest:

yarn start:admin-rest
yarn shop-rest

With this command, it'll give you an error that no build file is found. To resolve that, rebuild your project and then rerun the scripts.

https://chawkbazar-doc.vercel.app/vps-server#frontend-project-build

How to resolve javascript heap out of memory issue?

If you're using cPanel based server, then you maybe get an error like "call_and_retry_last allocation failed - javascript heap out of memory".

To resolve that issue, you've to add a limit of the memory bound,

Please check this,

https://stackoverflow.com/questions/38558989/node-js-heap-out-of-memory

https://support.snyk.io/hc/en-us/articles/360002046418-JavaScript-heap-out-of-memory

https://blog.openreplay.com/javascript-heap-out-of-memory-error

Image upload throw Internal Server Error; how to resolve that?

For uploading, the php8.1-gd library is required. So make sure you install the php8.1-gd library on your server.

Sometimes my server shutdown or halts automatically. After restart, it works fine again; how to resolve that?

In general, this happens mainly when your upstream server fails to handle its processing power when there is lots of traffic or requires lots of operation. Please upgrade your server configuration to double to check the issue. Please check this video,

https://www.youtube.com/watch?v=4pIqAz5bzX0

If that doesn't solve the issue, then you've to redeploy again with a new ec2 instance.

S3 uploading doesn't work after adding credentials to .env; how to resolve that?

For AWS s3, make sure your properly setup permission of the bucket with ACL enable by follow this link

https://stackoverflow.com/a/70603995/2158023

How to rebuild the project?

When you upload the code to the server as a production, NextJS fetch its code from the build file. So after deployed, when you update or change code on scripts, the updated scripts don't work at the front end until you rebuild the project again. NextJs works this way.

Now there are two ways you can follow to rebuild the project,

If your server has more than 2+ CPU core and 6GB+ of memory, then you can directly edit code at your server then rebuild the project from the server directly using this command,

At first go to /var/www/chawkbazar-laravel

For shop,

yarn build:shop-rest

And for admin,

yarn build:admin-rest

After completing the build, restart the PM2 process using this command,

pm2 restart 'all'

But suppose your server doesn't have that processing power, and you try to build your scripts directly from the server. In that case, your server will be shut down during the build, and you've to restart the server.

In that case, you can rebuild the scripts at your local computer and upload them to your server. If you follow our VPS Server Deployment guide, then you already know the process. To build the scripts on your pc, follow this procedure,

At first, download the chawkbazar-laravel folder from the server to your computer, and customize the code at your computer. Then use this command from the root folder,

To install all the packages,

yarn

Then build the shop,

yarn build:shop-rest

Then build the admin,

yarn build:admin-rest

Then delete the shop and admin folder from the server and upload your build shop and admin folder to the server at the exact same location and use this command to restart the PM2,

pm2 restart 'all'

How to increase upload size?

The API supports 10MB of upload limit for a single file by default. If your upload file is more than 10MB, then please follow this,

At first, login to the server using ssh, and then,

Edit,

/etc/php/1/fpm/php.ini

Then update,

upload_max_filesize = 256M
post_max_size = 256M
max_execution_time = 300

Then restart the PHP,

sudo service php8.1-fpm restart

Then update,

/etc/nginx/sites-enabled/chawkbazar

and Add client_max_body_size 256M

client_max_body_size 256M

BodyTime.png

Then restart the server,

sudo nginx -t
sudo service nginx restart

After that update,

chawkbazar-api/packages/marvel/config/media-library.php
'max_file_size' => 1024 * 1024 * 256,

UploadLimit.png

After that, run this command from the chawkbazar-api. folder,

php artisan optimize:clear

And for admin, increase timeout from,

admin/data/client/http-client.ts

IncreaseTime.png

timeout: 600000

After that Rebuild Your Project and restart again.

How to resolve docker: invalid reference format: repository name must be lowercase.?

Please open your terminal and use this command,

brew services stop mysql

It'll stop any MySQL instance that is installed using brew.

Then use this command to check is there MySQL running or not,

mysql -v

If no MySQL is running then, go to,

chawkbazar-laravel -> chawkbazar-api

and use this command,

./vendor/bin/sail down -v

After that,

Open docker dashboard and delete all the existing container and images,

DockerRemove1.png DockerRemove2.png DockerRemove3.png

And after that remove,

chawkbazar-laravel -> chawkbazar-api -> .env

And then go to your root chawkbazar-laravel folder and use this command again,

chmod +x install.sh
bash install.sh

How to remove the existing payment gateway?

You can remove the Stripe Payment from the available payment array,

shop/src/components/checkout/payment/payment-grid.tsx

Why checkout Place Order button is disabled?

The place order button will be activated only when you fill in this information,

  • OTP (Mobile number)
  • Billing Address
  • Shipping Address
  • Delivery Schedule
  • Payment Gateway

How do I log in to the admin panel as the main administrator?

When you install the API using php artisan marvel:install or using bash install.sh(docker), you'll get a prompt to create an admin account, and you've to create admin credentials that time. And then, you can use that credentials for the main admin account.

How to disable product popup view and redirect to a single product page?

At first edit shop/src/components/product/product-card.tsx

Import these two lines,

import { useRouter } from "next/router";
import { ROUTES } from "@lib/routes";

ImportModule.png

Then call useRouter,

const router = useRouter();

useRouter.png

Then update handlePopupView with this code,

router.push(`${ROUTES.PRODUCT}/${product?.slug}`, undefined, {
locale: router.locale,
});

routerPush.png