হোম / ডকুমেন্টেশন ও ইনস্টলেশন গাইড

সিপ্যানেল ও হোস্টিং ইনস্টলেশন গাইড

আপনার cPanel, Shared Hosting বা Cloud VPS-এ Landing Valley ই-কমার্স সোর্স কোড (.ZIP) আপলোড করে মাত্র ৩ থেকে ৫ মিনিটের মধ্যে লাইভ করার সম্পূর্ণ সচিত্র গাইড।

🚀 তাৎক্ষণিক ডাউনলোড
আপনি কি ইতোমধ্যে সোর্স কোড কিনেছেন?
আপনার ক্লায়েন্ট ড্যাশবোর্ড থেকে রিলিজ ফাইল (.ZIP) এবং অ্যাক্টিভেশন লাইসেন্স কী সংগ্রহ করুন।
🔑 ক্লায়েন্ট লগইন 🛒 লাইসেন্স প্যাকেজসমূহ

সার্ভার ও হোস্টিং রিকোয়ারমেন্টস (Server Requirements)

বাংলাদেশি যেকোনো স্ট্যান্ডার্ড cPanel / Shared / VPS হোস্টিংয়ে ১০০% কাজ করে

Landing Valley প্ল্যাটফর্মটি আধুনিক পিএইচপি (PHP 8.2+) আর্কিটেকচারে তৈরি। সাধারণ যেকোনো হোস্টিং প্রোভাইডারের cPanel-এ নিম্নের কনফিগারেশন ডিফল্টভাবেই উপলব্ধ থাকে:

PHP 8.2 বা 8.3
PHP Version
MySQL 5.7+ / MariaDB 10.3+
Database Engine
BCMath & PDO Extension
PHP Module
cURL, OpenSSL & Mbstring
PHP Security Modules
Fileinfo, GD & Tokenizer
Image & Upload Modules
Apache mod_rewrite
Clean URL Routing
💡 প্রো-টিপ: cPanel এর "Select PHP Version" বা "MultiPHP Manager" মেনু থেকে আপনার ডোমেনের জন্য PHP 8.2 সিলেক্ট করে রাখুন।

ধাপ ১: সোর্স কোড (.ZIP) ফাইল আপলোড ও এক্সট্র্যাক্ট

cPanel File Manager-এ ফাইল ট্রান্সফার নির্দেশিকা
  1. আপনার cPanel অ্যাকাউন্টে লগইন করুন এবং File Manager অপশনটিতে ক্লিক করুন।
  2. মূল ডোমেনের জন্য public_html ডিরেক্টরি ওপেন করুন (অথবা সাব-ডোমেন হলে সংশ্লিষ্ট সাব-ডোমেন ফোল্ডার ওপেন করুন)।
  3. উপরে মেনু থেকে Upload বাটনে ক্লিক করে Landing Valley ড্যাশবোর্ড থেকে ডাউনলোডকৃত সোর্স কোড জিপ ফাইলটি (cis-v1.0.0.zip) ড্র্যাগ অ্যান্ড ড্রপ করে আপলোড করুন।
  4. আপলোড সম্পন্ন (১০০% সবুজ) হলে ফোল্ডারে ফিরে আসুন এবং ZIP ফাইলটির উপর মাউসের রাইট ক্লিক করে Extract নির্বাচন করুন।
  5. ফাইলগুলো আনজিপ হওয়ার পর নিশ্চিত করুন যে index.php এবং .htaccess ফাইল সরাসরি public_html এর ভেতর রয়েছে।
📁 ফোল্ডার পারমিশন চেক: cPanel ফাইল ম্যানেজারে নিশ্চিত করুন যে storage এবং bootstrap/cache ফোল্ডার দুটির পারমিশন 755 বা 775 সেট করা আছে, যাতে সিস্টেম ফাইল লিখতে পারে।

ধাপ ২: cPanel এ MySQL ডাটাবেজ ও ইউজার তৈরি

MySQL Database Wizard ব্যবহারের নিয়ম

সফটওয়্যারের ডাটা সংরক্ষণের জন্য সিপ্যানেলে একটি নতুন ডাটাবেজ তৈরি করে নিতে হবে:

  1. cPanel এর মূল ড্যাশবোর্ডে গিয়ে MySQL® Database Wizard আইকনে ক্লিক করুন।
  2. Step 1 (Create A Database): ডাটাবেজের একটি নাম দিন (যেমন: shopdb) এবং Next Step ক্লিক করুন।
  3. Step 2 (Create Database Users): একটি ইউজারনেম দিন (যেমন: shopuser) এবং পাসওয়ার্ড জেনারেটরের মাধ্যমে একটি শক্তিশালী পাসওয়ার্ড সেট করুন।
  4. Step 3 (Add User to the Database): ALL PRIVILEGES বক্সে টিক চিহ্ন দিন এবং Make Changes বাটনে চাপুন।
⚠️ নোট করুন: আপনার ডাটাবেজের সম্পূর্ণ নাম (যেমন: cpaneluser_shopdb), ইউজারনেম এবং পাসওয়ার্ডটি একটি টেক্সট ফাইলে সাময়িকভাবে সেভ রাখুন, পরবর্তী ধাপে প্রয়োজন হবে।

ধাপ ৩: অটোমেটিক ওয়েব ইনস্টলার ও লাইসেন্স সক্রিয়করণ

কোনো কোডিং ছাড়া ব্রাউজারে ৩-ক্লিক অটো ইনস্টলেশন

ফাইল আপলোড এবং ডাটাবেজ তৈরি শেষে আপনার ব্রাউজারে নতুন ট্যাব খুলে সরাসরি আপনার ওয়েবসাইটের ঠিকানায় যান:

https://yourdomain.com/install
১. সার্ভার রিকোয়ারমেন্টস চেক (Check Requirements)

উইজার্ড স্বয়ংক্রিয়ভাবে পিএইচপি ভার্সন ও এক্সটেনশন স্ক্যান করে সবুজ সংকেত দেখাবে। Continue ক্লিক করুন।

২. ডাটাবেজ কানেকশন তথ্য দিন (Database Credentials)

ধাপ ২-এ তৈরি করা Database Name, Database Username এবং Password ইনপুট করুন। Host সাধারণত localhost বা 127.0.0.1 থাকে।

৩. লাইসেন্স কী ও অ্যাডমিন একাউন্ট সেটআপ (License Activation)

আপনার Landing Valley ক্লায়েন্ট ড্যাশবোর্ড থেকে লাইসেন্স কী কপি করে বসিয়ে দিন এবং আপনার সুপার অ্যাডমিন ইমেইল ও পাসওয়ার্ড সেট করে "Finish Installation" বাটনে ক্লিক করুন।

🎉 অভিনন্দন! ইনস্টলেশন সফল হওয়ার সাথে সাথে ডাটাবেজের সকল টেবিল ও ৪৫টি প্রি-মেড হাই-কনভার্টিং টেমপ্লেট স্বয়ংক্রিয়ভাবে লোড হয়ে যাবে এবং আপনার ডোমেন লাইভ হয়ে যাবে।

ধাপ ৪: ম্যানুয়াল কনফিগারেশন (.env Setup)

ডেভেলপার এবং অ্যাডভান্সড ইউজারদের জন্য বিকল্প পদ্ধতি

যদি আপনি ওয়েব ইনস্টলার ব্যবহার না করে ম্যানুয়ালি কনফিগার করতে চান, তবে cPanel File Manager-এ গিয়ে .env.example ফাইলটিকে কপি/রিনেম করে .env করুন এবং নিচের প্যারামিটারগুলো পূরণ করুন:

APP_NAME="Landing Valley Single Product Store"
APP_ENV=production
APP_KEY=base64:GENERATE_YOUR_APP_KEY_HERE
APP_DEBUG=false
APP_URL=https://yourdomain.com

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=yourcpanel_shopdb
DB_USERNAME=yourcpanel_shopuser
DB_PASSWORD=your_secure_password

CLMS_API_URL=https://landingvalley.com/api/v1

এরপর cPanel এর phpMyAdmin ওপেন করে জিপ ফাইলের সাথে থাকা database.sql ফাইলটি ইমপোর্ট (Import) করে নিন।

ধাপ ৫: cPanel এ ক্রন জব (Cron Job) শিডিউল সেটআপ

অটোমেটেড এসএমএস নোটিফিকেশন ও লাইসেন্স ভ্যালিডেশনের জন্য আবশ্যক

সাইটে কার্ড অ্যান্ড ড্রপশিপিং অর্ডার ট্র্যাকিং, লাইসেন্স সিঙ্ক এবং কুরিয়ার স্ট্যাটাস আপডেট স্বয়ংক্রিয়ভাবে চালু রাখতে cPanel-এ প্রতি মিনিটে একটি ক্রন জব শিডিউল সেট করতে হয়:

  1. cPanel ড্যাশবোর্ডে সার্চ বক্সে টাইপ করুন Cron Jobs এবং ওপেন করুন।
  2. Common Settings থেকে সিলেক্ট করুন Once Per Minute (* * * * *)
  3. Command বক্সে নিচের কমান্ডটি পেস্ট করুন (আপনার হোস্টিংয়ের সঠিক পাথ অনুযায়ী):
/usr/local/bin/php /home/username/public_html/artisan schedule:run >> /dev/null 2>&1
💡 সতর্কতা: কমান্ডে থাকা username পরিবর্তন করে আপনার cPanel এর সঠিক ইউজারনেম দিন।

ধাপ ৬: ফ্রি SSL সার্টিফিকেট (HTTPS) সক্রিয়করণ

বিকাশ ও পেমেন্ট গেটওয়ের সিকিউরড কানেকশনের জন্য অপরিহার্য

বিকাশ, নগদ বা ব্যাংক পেমেন্ট গেটওয়েতে লেনদেন করার জন্য আপনার ডোমেনে বাধ্যতামূলক SSL (https://) সক্রিয় থাকতে হবে:

  1. cPanel ড্যাশবোর্ড থেকে SSL/TLS Status অপশনে যান।
  2. আপনার মূল ডোমেন এবং www সাব-ডোমেনের পাশের চেক-বক্সে টিক দিন।
  3. উপরে থাকা নীল বাটন "Run AutoSSL" ক্লিক করুন।
  4. ২ থেকে ৩ মিনিটের মধ্যে সবুজ প্যাডলক আইকন সহ ফ্রি লাইফটাইম SSL সক্রিয় হয়ে যাবে।
🛠️

সমস্যা সমাধান ও প্রশ্নোত্তর (Troubleshooting & FAQs)

ইনস্টলেশনের সময় সাধারণ সমস্যার সহজ সমাধান

❓ ১. সাইট ওপেন করলে 500 Internal Server Error দেখাচ্ছে?

এটি সাধারণত ফাইল পারমিশনের কারণে হয়। cPanel File Manager থেকে storage এবং bootstrap/cache ফোল্ডারের পারমিশন 755 বা 775 করে দিন। এছাড়া .env ফাইল সঠিক আছে কিনা পরীক্ষা করুন।

❓ ২. Database Connection Refused বা Access Denied এরর আসলে কী করব?

cPanel এ তৈরি করা ডাটাবেজ ইউজারকে ALL PRIVILEGES দেওয়া হয়েছে কিনা নিশ্চিত হন। যদি DB_HOST=127.0.0.1 কাজ না করে তবে DB_HOST=localhost দিয়ে চেষ্টা করুন।

❓ ৩. সাব-পেজ বা অ্যাডমিন প্যানেলে 404 Not Found আসলে কী করব?

নিশ্চিত করুন আপনার হোস্টিংয়ে public_html/.htaccess ফাইলটি সঠিকভাবে উপস্থিত আছে। ফাইল ম্যানেজারের সেটিংসে গিয়ে "Show Hidden Files (dotfiles)" চালু রাখুন।

❓ ৪. "License Domain Limit Exceeded" এরর দেখালে সমাধান কী?

আপনার কেনা প্যাকেজে নির্ধারিত ডোমেনের চেয়ে বেশি ডোমেনে ইনস্টল করতে চাইলে ক্লায়েন্ট ড্যাশবোর্ড থেকে লাইসেন্স আপগ্রেড করুন অথবা পূর্বের টেস্ট ডোমেন রিসেট করে নিন।

👨‍💻

এখনও ইনস্টল করতে কোনো সমস্যা হচ্ছে?

কোনো চিন্তা করবেন না! আমাদের সাপোর্ট ইঞ্জিনিয়াররা সরাসরি এনিডেস্ক (AnyDesk) বা সিপ্যানেল অ্যাক্সেসের মাধ্যমে আপনার সাইট লাইভ করে দিতে সবসময় প্রস্তুত।