Custom WooCommerce Invoice Generator (CIG)

Version: 4.0.0
Requires PHP: 7.4+
Requires WooCommerce: 5.0+
HPOS Compatible: Yes

Custom WooCommerce Invoice Generator (CIG) არის მძლავრი და მოქნილი WordPress პლაგინი, რომელიც შექმნილია ინვოისების, მარაგების რეზერვაციისა და ფინანსური აღრიცხვის ავტომატიზაციისთვის. პლაგინი იყენებს საკუთარ მონაცემთა ბაზის ცხრილებს (Custom Database Tables) მაღალი წარმადობისთვის და უზრუნველყოფს სრულ სინქრონიზაციას WooCommerce-ის მარაგებთან.

🚀 ძირითადი ფუნქციონალი

1. ინვოისების მართვა

სისტემა მხარს უჭერს ინვოისის სხვადასხვა სასიცოცხლო ციკლს:

• Fictive (ფიქტიური): ინვოისი იქმნება, მაგრამ არ აკლდება მარაგს და არ ისახება შემოსავლებში.
• Reserved (დარეზერვებული): პროდუქცია დაჯავშნილია კლიენტისთვის (სისტემა ითვლის "Reserved Stock"-ს), მაგრამ WooCommerce-ის მთავარ მარაგს ჯერ არ აკლდება.
• Sold (გაყიდული): ტრანზაქცია დასრულებულია, მარაგი ოფიციალურად ჩამოიჭრა WooCommerce-იდან და თანხა აისახა სტატისტიკაში.
• Date Logic: ფიქტიურიდან აქტიურ სტატუსში გადასვლისას, გაყიდვის თარიღი (sale_date) ავტომატურად განახლდება მიმდინარე დროით.

2. მარაგების კონტროლი (Advanced Stock Management)

• Real-time Sync: WooCommerce-ის სტოკების რეალურ დროში კონტროლი.
• Prevention: სისტემა არ გაგაყიდინებთ პროდუქტს, თუ ის სტოკში არ არის.
• Duplicate Prevention: ოპტიმიზებული SQL რეპორტები (GROUP BY ლოგიკით) სტოკების ზუსტი აღრიცხვისთვის.

3. როლებისა და უფლებების მართვა

• Admin Portal: სრული წვდომა ყველა ფუნქციაზე.
• Accountant View: შეზღუდული წვდომა მხოლოდ ფინანსურ მონაცემებსა და ინვოისებზე.
• Frontend Dashboard: სპეციალური ინტერფეისი, რომელიც მუშაობს wp-admin-ის გარეშე.

4. ტექნიკური მახასიათებლები

• Custom Tables: იყენებს wp_cig_invoices, wp_cig_invoice_items, wp_cig_payments და wp_cig_customers ცხრილებს, რაც საგრძნობლად ზრდის სისწრაფეს wp_postmeta-სთან შედარებით.
• AJAX Driven: ცხრილები, ძებნა და ფილტრაცია მუშაობს AJAX-ზე გვერდის გადატვირთვის გარეშე.
• Frontend Assets: Dashicons-ის და სტილების ავტომატური ჩატვირთვა არა-ადმინი მომხმარებლებისთვის.

🛠 ინსტალაცია

1. ატვირთეთ პლაგინის ფაილები /wp-content/plugins/custom-woocommerce-invoice-generator დირექტორიაში.
2. გააქტიურეთ პლაგინი WordPress-ის "Plugins" მენიუდან.
3. დარწმუნდით, რომ WooCommerce აქტიურია.
4. აქტივაციისას პლაგინი ავტომატურად შექმნის საჭირო ცხრილებს მონაცემთა ბაზაში (dbDelta-ს გამოყენებით).

💻 გამოყენება (Shortcodes)

პლაგინი გვთავაზობს რამდენიმე შორთკოდს ფუნქციონალის ფრონტენდზე გამოსატანად:

📊 მონაცემთა ბაზის სტრუქტურა

პლაგინი ქმნის შემდეგ ცხრილებს:

• cig_invoices - ინვოისის ჰედერი (ნომერი, სტატუსი, თარიღები).
• cig_invoice_items - ინვოისის პროდუქტები (JSON-ის ნაცვლად რელაციური ჩაწერა).
• cig_payments - გადახდების ისტორია.
• cig_customers - კლიენტების ბაზა.

🔄 განახლებები (Changelog)

v4.0.0

• New: სრული გადასვლა Custom Database Tables-ზე.
• Fix: "Cascading Delete" - ინვოისის წაშლისას იწმინდება ყველა დაკავშირებული მონაცემი.
• Fix: Stock Table Duplication - გასწორდა პროდუქტების დუბლირების პრობლემა რეპორტებში.
• Improvement: Dashicons-ის მხარდაჭერა ფრონტენდზე ყველა მომხმარებლისთვის.
• Improvement: Fictive -> Active სტატუსის ცვლილებისას თარიღის ავტომატური განახლება.

Author: Samsiani
License: GPL v2 or later