Question & Answer:

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.
4. Then copy Secret key to your pickbazar api->.env

5. And similarly, add Publishable key to your frontend/shop-rest/.env for rest and frontend/shop-graphql/.env for graphql.

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

For REST API

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

And for GraphQL,

yarn build:shop-gql
yarn build:admin-gql

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

6. 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",
"pickbazar/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": {
        "pickbazar/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

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 api -> .env.

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 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

Admin

Then add your domain to your pickbazar-laravel -> admin -> rest -> next.config.js for rest or pickbazar-laravel -> admin -> graphql -> next.config.js for graphql

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

Shop

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

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

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://pickbazar-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:

3000 -> Shop Rest
3001 -> Admin Rest

3000 -> Shop GraphQL
3004 -> Admin GraphQL

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

pm2 stop 'all'

then go to the pickbazar 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

GraphQL:

yarn start:admin-gql

yarn shop-gql

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 pickbazar 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

GraphQL:

yarn start:admin-gql

yarn shop-gql

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://pickbazar-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.

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

To resolve that issue, you've to move the laravel-ecommerce folder from Pickbazar Laravel - React Next REST & GraphQL Ecommerce to a genric folder where you store your code. After that, use this command from your laravel-ecommerce folder,

chmod +x install.sh
bash install.sh

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/pickbazar-laravel

For shop rest.

yarn build:shop-rest

for graphql yarn build:shop-gql

And for admin rest.

yarn build:admin-rest

for graphql yarn build:admin-gql

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 pickbazar-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 rest,

yarn build:shop-rest

for graphql yarn build:shop-gql

Then build the admin rest,

yarn build:admin-rest

for graphql yarn build:admin-gql

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/8.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/pickbazar

and Add client_max_body_size 256M

client_max_body_size 256M

Then restart the server,

sudo nginx -t
sudo service nginx restart

After that update,

api/packages/marvel/config/media-library.php

'max_file_size' => 1024 * 1024 * 256,

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

php artisan optimize:clear

And for admin, increase timeout from,

admin/data/client/http-client.ts

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,

pickbazar-laravel -> api

and use this command,

./vendor/bin/sail down -v

After that,

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

And after that remove,

pickbazar-laravel -> api -> .env

And then go to your root pickbazar-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 upgrade the existing deployed laravel 8 server to laravel 9?

At first, remove all the existing php 7.4 and its extensions by using this command,

sudo apt purge php-fpm php-mysql
sudo apt purge php-mbstring php-xml php-bcmath php-simplexml php-intl php-mbstring php7.4-gd php7.4-curl php7.4-zip composer

Then remove the composer,

sudo rm /usr/bin/composer

Then delete the vendor folder from the pickbazar-laravel -> api folder.

cd /var/www/pickbazar-laravel/api

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

rm vendor -rf

Then install PHP 8, and its extensions,

sudo add-apt-repository ppa:ondrej/php
sudo apt update

sudo apt install php8.0-fpm php8.0-mysql

sudo apt install php8.0-mbstring php8.0-xml php8.0-bcmath php8.0-simplexml php8.0-intl php8.0-mbstring php8.0-gd php8.0-curl php8.0-zip

php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php -r "if (hash_file('sha384', 'composer-setup.php') === 'e21205b207c3ff031906575712edab6f13eb0b361f2085f1f1237b7126d785e826a450292b6cfd1d64d92e6563bbde02') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"
php composer-setup.php
php -r "unlink('composer-setup.php');"

sudo mv composer.phar /usr/bin/composer

Then update 7.4 fpm to 8.0 fpm from,

/etc/nginx/sites-enabled/pickbazar

Then install composer packages,

cd /var/www/pickbazar-laravel/api

composer install

php artisan optimize:clear

php artisan marvel:install

php artisan marvel:install will remove all of your existing data. Ensure you export or backup your data before using that command.

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

How to turn off Strict Mode of next.js to avoid double rendering of data?

The Next.js runtime is Strict Mode-compliant. To opt-in to Strict Mode, configure the following option in your next.config.js:

module.exports = {
  reactStrictMode: true,
}

If you or your team are not ready to use Strict Mode in your entire application, that's OK! You can incrementally migrate on a page-by-page basis using <React.StrictMode>.

Strict Mode is true by default with app router, so the above configuration is only necessary for pages. You can still disable Strict Mode by setting reactStrictMode: false.

• For further details please checkout the following documentation: https://react.dev/reference/react/StrictMode

How to display whole numbers instead of fractions in product prices and checkouts when the system restricts setting the number of decimal digits to zero?

Please refer to the files listed below if you want remove fractional numbers, and change them as necessary:

1. Admin file: rest/src/utils/use-price.ts
2. Shop file: src/lib/use-price.tsx

Moreover, please ensure that your Next.js developer examines the provided documentation for additional insights: Link to the documentation.

Can i use cPanel hosting?

We do not support any cPanel hosting. We don't recommend using managed or shared servers because most of them lack processing powers to handle NodeJS apps, and they change their internal architecture, which requires intensive research on how they work internally and how proxy forwarding requires to customize. There is a couple of thousands of provider on the internet, and unfortunately, it's not possible to support all of them. Also, It's pretty hard to debug any deployment issue on the cPanel or any managed server as the provider manages this type of server, and they've complete control of the server. And for that, We don't recommend Cpanel or any managed server for deployment.

Which node version is supported in Pickbazar Laravel?

The node version 20 is the latest stable version suported on our system.

What are the necessary steps that is needed to followed while installing Pickbazar on linux/osx operating system?

To setup Pickbazar on linux/osx operating system please follow and ensure the following steps:

1. Ensure that your API is up and running.
2. Open a new terminal.
3. Navigate to the admin folder.
4. Create a .env folder by duplicating .env.example.
5. Run the command "yarn."
6. Verify that you have properly set the API endpoint in the .env file.
7. Now run yarn dev:admin-gql
8. Please find attached some additional documents for your reference.
9. Also, you can follow our online doc on installation. We have also a video on installation.

How to create any new controller and models inside marvel package?

To create any new controller and models inside marvel package please follow the following steps:

1. Please run this command in your terminal.

composer dump-autoload

2. Then run the follwing into the same terminal.

php artisan optimize:clear

How to connect s3 aws to laravel project?

To support s3 aws to laravel project please change the following code on the .env file.

MEDIA_DISK=s3 
FILESYSTEM_DRIVER=s3

Do you provide installation service?

Yes, we do provide a premium installation service. Our installation service is the fastest way to get started with the Pickbazar Laravel - React, Next, REST & GraphQL Ecommerce With Multivendor script. We offer this on demand service based on request so that our customer can have their Pickbazar demo site ready in quickest time possible. Currently Pickbazar Laravel installation service comes only at a standard price of $200.

Consider this service if:

• You need ready made demo site in quickest time possible
• You want to see if Pickbazar Laravel can be installed on your own server
• You want to have the site run in your own domain
• You don't know how to deploy in production
• You don't have enough time to learn the resources
• You are looking for a professional service

How to get the premium installation service?

To avail the premium installation service please ensure the following requirements:

• Full upfront payment of fixed $200.
• Payment to PayPal ID with the confirmed receipt option.
• AWS server access(EC2, Lightsail).
• Ubuntu based blank server.
• SSH credentials of the server.
• Make sure the domain is appropriately mapping with the server.

What does the premium installation service package include?

The Pickbazar Laravel - React, Next, REST & GraphQL Ecommerce With Multivendor script can be quickly and easily installed with our installation service. In order to help our customers launch their Pickbazar sample site as soon as possible, we provide this on-demand service upon request.

Here is the list of services that will be provided under the premium installation service:

• Installation of the script on your own server.
• Import the demo data and make your site like our demo site.
• Pickbazar demo site running on your own server.
• Delivery within 1-3 working days after order confirmation.

What does the premium installation service package not include?

The premium installation service will not include the following services:

• Installation server can not be changed.
• It's an one time service that means once it delivered it's your responsibility.
• Refund, We don't offer any Refund.
• This service is only applicable for AWS (lightsail, EC2) server. So cPanel, Heroku or any other similar server is not applicable for this service.
• No instruction will be provided to install or import the demo data.
• Domain mapping service.
• Ubuntu installation.

Do you provide any PostgreSQL support?

Unfortunately, PostgreSQL is not supported at the moment. We will explore the potential for future support additions.

Do you have a mobile app for this product?

Unfortunately, we don't have any mobile app for the pickbazar.

Is there any service available for installation via docker-compose?

We used laravel sail which provides laravel itself, and unfortunately, laravel sail doesn't support for production deployment yet. So right now, unfortunately, it's not possible for docker deployment. But we have a plan to provide docker deployment support in the future.