Fina ↔ WooCommerce — სწრაფი დაყენება
დააკავშირეთ Fina და WooCommerce ისე, რომ პროდუქტები, ფასები და ნაშთები Fina-დან მაღაზიაში განრიგის მიხედვით გადმოვიდეს. დაყენებას დაახლოებით 30 წუთი სჭირდება, ხოლო დიდი კატალოგის შემთხვევაში პირველ იმპორტს შესაძლოა დამატებით 10-20 წუთი დასჭირდეს.
fina-syncდაწყებამდე
პირველ სინქრონიზაციამდე მოამზადეთ API-ზე წვდომა და SKU-ს წესები. Fina რჩება მონაცემთა ძირითად წყაროდ: პლაგინი ინფორმაციას Fina → WooCommerce მიმართულებით წამოიღებს.
- აქტიური Fina-ს ანგარიში API-ზე წვდომით. თუ API ჩართული არ გაქვთ, Fina-ს მენეჯერს სთხოვეთ ინტეგრაციის გააქტიურება.
- Fina-სგან მიღებული API base URL, API login, API password და price type ID. price type ID განსაზღვრავს, ფასის რომელი სვეტი წამოიღოს პლაგინმა.
- WordPress-ის ადმინპანელზე წვდომა და აქტიური WooCommerce. სასურველია SKU-ები მოწესრიგებული იყოს, რადგან პროდუქტების დაკავშირება ძირითადად SKU-სა და Fina-ს პროდუქტის ID-ს ეყრდნობა.
შეიძინეთ Fina ↔ WooCommerce ლიცენზია
გახსენით Fina-ს სინქრონიზაციის პროდუქტის გვერდი და დააჭირეთ Buy license-ს. ლიცენზია ღირს ₾450 წელიწადში ერთ დომენზე და მოყვება თანხის დაბრუნების 14-დღიანი გარანტია.
ჩამოტვირთეთ პლაგინის ZIP ფაილი
შედით თქვენს ანგარიშში, გახსენით codeon.ge/downloads, მოძებნეთ Fina ↔ WooCommerce და დააჭირეთ Download-ს.
დააყენეთ პლაგინი WordPress-ში
WordPress-ის ადმინპანელში გადადით Plugins → Add New → Upload Plugin-ზე. აირჩიეთ ZIP ფაილი, დააჭირეთ Install Now-ს და შემდეგ Activate Plugin-ს.
აქტივაციის შემდეგ WordPress-ის გვერდით მენიუში გამოჩნდება ცალკე განყოფილება — Fina Sync. ლიცენზიის კოდის მოთხოვნის შეტყობინება გადაგიყვანთ License ჩანართზე.
გააქტიურეთ ლიცენზია
ჩასვით ლიცენზიის კოდი License key ველში და დააჭირეთ Save changes-ს.
- Active სტატუსი მიუთითებს, რომ ლიცენზიის კოდი აქტიურია.
- დომენი ლიცენზიის კოდს პირველივე გამოყენებისას ებმება.
- გამოჩნდება Settings ჩანართი, ხოლო ლიცენზიის ველი დაიმალება.
დააკავშირეთ Fina-ს ანგარიში
Settings ჩანართში მიუთითეთ Fina-ს წვდომის მონაცემები, ფასის სვეტი და სინქრონიზაციის პერიოდულობა.
- API base URL
- Fina-ს API მისამართი. თუ არ იცით, Fina-ს მხარდაჭერის გუნდს ჰკითხეთ.
- API login
- Fina-ს API მომხმარებელი. ხშირად ის სამართავი პანელის ლოგინისგან განსხვავდება.
- API password
- API მომხმარებლის პაროლი. პლაგინი მას დაშიფრულად ინახავს, ხოლო ავტორიზაციის ტოკენს ქეშში 25 წუთის განმავლობაში ინარჩუნებს.
- Price type ID
- Fina-ს ფასის სვეტის რიცხვითი იდენტიფიკატორი (ID). უმეტეს მაღაზიაში გამოიყენება
1, თუმცა თუ ფასების რამდენიმე სია გაქვთ, Fina-ს მხარეს გადაამოწმეთ. - Schedule
- რამდენად ხშირად გაეშვას სინქრონიზაცია. ნაგულისხმევად რეკომენდებულია
1 hour. მხოლოდ ხელით გაშვების რეჟიმისთვის საათები და წუთები 0-ზე დააყენეთ. - Batch size
- რამდენი პროდუქტი დამუშავდეს ერთ ეტაპზე. ნაგულისხმევია
150, დასაშვები შუალედი:10-500.
ღილაკზე Save changes დაჭერის შემდეგ პლაგინი Fina-ს ავტორიზაციის მისამართს შეამოწმებს. მწვანე სტატუსი Connected ნიშნავს, რომ მონაცემები სწორია. წითელი სტატუსი უმეტესად პაროლის შეცდომაზე ან არააქტიურ API მომხმარებელზე მიუთითებს.
პირველი იმპორტი ხელით გაუშვით
სანამ ავტომატურ განრიგს ენდობით, პირველი იმპორტი ხელით გაუშვით: შედით მენიუში Fina Sync → Dashboard და დააჭირეთ ღილაკს Import. პლაგინი Fina-დან წამოიღებს პროდუქტებს, ფასებსა და ნაშთებს. შემდგომი Update გაშვებები watermark-ს (ცვლილებების ნიშნულს) დაეყრდნობა და მხოლოდ შეცვლილ პროდუქტებს შეეხება.
- Products in sync: WooCommerce-ის იმ პროდუქტების რაოდენობა, რომლებიც Fina-ს ჩანაწერებს უკავშირდება.
- Stock / Price changes today: აჩვენებს, რამდენ პროდუქტზე შეიცვალა ნაშთი ან ფასი დღევანდელი გაშვების შედეგად.
- Recent runs: ბოლო სინქრონიზაციების ისტორია სტატუსებით. კონკრეტულ სტრიქონზე დაჭერით დეტალური ლოგი იხსნება.
განრიგის ამოქმედება
როგორც კი ხელით გაშვებას გადაამოწმებთ, განრიგი ავტომატურად ამოქმედდება. დამატებითი ჩამრთველი საჭირო არ არის — არჩეული პერიოდულობა იმ მომენტიდან იწყებს მუშაობას, როცა კავშირს შეინახავთ.
ყოველდღიური მუშაობა
- სად ჩანს პროცესი: Fina Sync → Dashboard. მაჩვენებლების ბარათები და ბოლო გაშვებების ცხრილი გაჩვენებთ დღევანდელ ცვლილებებსა და ბოლო პროცესებს.
- როგორ გაუშვათ სინქრონიზაცია ახლავე: Dashboard-ზე დააჭირეთ Import-ს მონაცემების სრულად წამოსაღებად ან Update-ს მხოლოდ ცვლილებების გასაახლებლად.
- რატომ დასრულდა პროცესი გაფრთხილებით ან შეცდომით: ბოლო გაშვებების ცხრილში გახსენით შესაბამისი სტრიქონი. დეტალურ ხედში გამოჩნდება SKU-ების დამთხვევა (collision), Fina-ს API-ის შეცდომა თუ სხვა მიზეზი.
- WP-CLI:
wp fina-sync import,wp fina-sync update,wp fina-sync status.
ხშირი შეცდომები
License key doesn't cover this plugin- გადახდის პლაგინის ლიცენზიის კოდი Fina-ს პლაგინში ჩასვით. გადაამოწმეთ /licenses გვერდზე.
Fina: 401 unauthorized- API-ის მომხმარებელი ან პაროლი არასწორია, ან API-ის მომხმარებელი ჯერ აქტიური არ არის. პაროლის შეცვლის შემდეგ Settings თავიდან შეინახეთ ტოკენის ქეშის გასასუფთავებლად.
SKU collision: N products skipped- SKU იდენტურია, მაგრამ პროდუქტები განსხვავებულია. გაასწორეთ SKU ან გააერთიანეთ პროდუქტები.
requires PHP version 8.1 or higher- ჰოსტინგზე PHP 7.4 ან 8.0 ვერსიაა. მართვის პანელიდან ჩართეთ PHP 8.1 ან უფრო ახალი.
Fina: rate limit exceeded- API მეტისმეტად ხშირად გამოიძახება. საათში ერთხელ სინქრონიზაცია სტანდარტულია, ყოველწუთიერი გაშვება კი შეიძლება მოთხოვნების ლიმიტს გადააჭარბოს.
შემდეგი ნაბიჯები
- დაამატეთ გადახდის პლაგინი, თუ ჯერ არ გაქვთ: TBC Card, BOG Card ან Flitt.
- სინქრონიზაციის მოვლენებზე ავტომატიზაცია გჭირდებათ? ინტეგრატორის დოკუმენტაცია დეტალურად აღწერს პროცესის დასრულების webhook-ებსა და REST API-ის შესაძლებლობებს.