User Guide – Stock Manager για OpenMage / Magento 1

Ο οδηγός βασίζεται στον πραγματικό κώδικα του module και εξηγεί τι μπορεί να ρυθμίσει ο διαχειριστής.

Admin paths

• IOWEB -> Stock Manager -> Configuration
• IOWEB -> Stock Manager -> Label Elements

Frontend tool paths

• /iowebstockmanager/index/tools
• /iowebstockmanager/stock/manager
• /iowebstockmanager/label/printWithBarcode

Τα εργαλεία προστατεύονται με HTTP digest login. Τα credentials ορίζονται από το Magento admin.

Αρχική ρύθμιση

1. Ανοίξτε IOWEB -> Stock Manager -> Configuration.
2. Στο group Configuration ορίστε Active = Yes.
3. Ορίστε username και password για το Stock Manager interface.
4. Στο group Barcode Labels ορίστε label width και label height σε millimeters.
5. Κρατήστε το Debug Mode απενεργοποιημένο εκτός αν ρυθμίζετε την ετικέτα.
6. Κάντε save και καθαρίστε cache.
7. Ανοίξτε /iowebstockmanager/index/tools και συνδεθείτε με τα credentials.

Configuration fields

Active
Ενεργοποιεί την πρόσβαση στα Stock Manager frontend tools. Όταν είναι disabled, τα σχετικά endpoints επιστρέφουν disabled response.

Username
Username για το HTTP digest login. Προτείνεται dedicated operational user, όχι Magento admin username.

Password
Password για το HTTP digest login. Αλλάξτε το όταν αλλάζει η πρόσβαση προσωπικού.

Label Width / Label Height
Οι πραγματικές διαστάσεις κάθε label σε millimeters. Χρησιμοποιούνται ως page size στο TCPDF PDF.

Debug Mode
Χρήσιμο προσωρινά για έλεγχο του label layout και των element rectangles.

Label Elements

Από IOWEB -> Stock Manager -> Label Elements ορίζετε τι θα τυπωθεί στην ετικέτα.

• Attribute Code: product attribute που θα τυπωθεί, π.χ. sku, name, price, barcode_ean13.
• X / Y: θέση σε millimeters από αριστερά και από πάνω.
• Width / Height: διαστάσεις του element σε millimeters.
• Xres: barcode x-resolution, κυρίως για barcode_ean13.
• Font Family / Font Style / Font Size: γραμματοσειρά και εμφάνιση.
• Type: Text ή Number.
• Precision: δεκαδικά ψηφία για numeric values.
• Max Length: μέγιστο μήκος για text values.
• Align: Left ή Right.
• Prefix / Suffix: κείμενο πριν ή μετά την τιμή.

Τα default label elements είναι SKU, name, barcode_ean13 και price.

Stock update με barcode

1. Ανοίξτε /iowebstockmanager/stock/manager.
2. Επιλέξτε action - για μείωση ή + για αύξηση κατά 1.
3. Σκανάρετε ή πληκτρολογήστε barcode.
4. Πατήστε Enter.
5. Το module βρίσκει προϊόν από το barcode_ean13, ενημερώνει stock και εμφανίζει SKU, price και νέα ποσότητα.

Stock update με SKU

1. Πληκτρολογήστε τουλάχιστον 3 χαρακτήρες SKU για autocomplete.
2. Αναζητήστε το προϊόν.
3. Ελέγξτε την τρέχουσα ποσότητα.
4. Χρησιμοποιήστε + / – ή γράψτε ακριβή ποσότητα.
5. Πατήστε save.

Η SKU lookup ροή απορρίπτει configurable products, επειδή το stock πρέπει να ενημερώνεται στο πραγματικό stock item.

Barcode label printing

1. Ανοίξτε /iowebstockmanager/label/printWithBarcode.
2. Αναζητήστε SKU.
3. Αν το SKU είναι configurable, εμφανίζονται τα child products.
4. Ορίστε πόσες ετικέτες θέλετε για κάθε προϊόν.
5. Πατήστε Print Labels.
6. Το module δημιουργεί PDF με TCPDF σε νέο browser target.

Αν προϊόν δεν έχει barcode, το module μπορεί να δημιουργήσει EAN13 από το Magento product ID και να το αποθηκεύσει στο barcode_ean13.

Testing checklist

1. Ενεργοποιήστε το module και βάλτε credentials.
2. Ελέγξτε ότι το tools URL ζητά login.
3. Δοκιμάστε SKU search με simple product.
4. Αλλάξτε quantity και επιβεβαιώστε το Magento stock item.
5. Δοκιμάστε barcode increase/decrease.
6. Τυπώστε ένα test label.
7. Ρυθμίστε label elements με Debug Mode προσωρινά ενεργό.
8. Απενεργοποιήστε Debug Mode μετά το layout testing.