Added ajax functionality and ui hints
authorJanusz Dobrowolski <janusz@frontaccounting.eu>
Fri, 6 Jun 2008 22:19:54 +0000 (22:19 +0000)
committerJanusz Dobrowolski <janusz@frontaccounting.eu>
Fri, 6 Jun 2008 22:19:54 +0000 (22:19 +0000)
sales/includes/ui/sales_order_ui.inc
sales/sales_order_entry.php

index 5b8b69e6c343dbcd92b0f6c643ee1776a2a7727e..bf08381ce1949b836e7eff5dffa8d8f7ae1f2142 100644 (file)
@@ -4,7 +4,6 @@ include_once($path_to_root . "/sales/includes/cart_class.inc");
 include_once($path_to_root . "/includes/manufacturing.inc");
 
 //--------------------------------------------------------------------------------
-
 function add_to_order(&$order, $new_item, $new_item_qty, $price, $discount)
 {
 
@@ -33,13 +32,6 @@ function get_customer_details_to_order(&$order, $customer_id, $branch_id)
        if ($myrow['dissallow_invoices'] == 1)
                $ret_error = _("The selected customer account is currently on hold. Please contact the credit control personnel to discuss.");
 
-/*     if (!isset($_POST['branch_id']) || $_POST['branch_id'] == "")
-       {
-               $ret_error = _("The selected customer does not have any branches. Please create at least one branch.");
-               unset($_POST['branch_id']);
-               $order->Branch = 0;
-       }
-*/
        $deliver = $myrow['address']; // in case no delivery address.
 
        $order->set_customer($customer_id, $name, $myrow['curr_code'], $myrow['discount']);
@@ -55,7 +47,7 @@ function get_customer_details_to_order(&$order, $customer_id, $branch_id)
                if (db_num_rows($result) == 0)
                {
                return _("The selected customer and branch are not valid, or the customer does not have any branches.");
-               }
+               } 
 
                $myrow = db_fetch($result);
 
@@ -79,19 +71,22 @@ function get_customer_details_to_order(&$order, $customer_id, $branch_id)
 
 function display_order_summary($title, &$order, $editable_items=false)
 {
-       global $table_style, $path_to_root;
+       global $table_style, $path_to_root, $Ajax;
 
        display_heading($title);
+
+    div_start('items_table');
        start_table("$table_style colspan=7 width=90%");
        $th = array(_("Item Code"), _("Item Description"), _("Quantity"),
                _("Delivered"),
                _("Unit"), _("Price"), _("Discount %"), _("Total"), "");
 
-       if ($order->trans_no==0) {
+       if ($order->trans_no == 0) {
        unset( $th[3] );
        }
 
-       if (count($order->line_items)) $th[]= '';
+       if (count($order->line_items))
+            $th[]= '';
 
        table_header($th);
 
@@ -99,7 +94,6 @@ function display_order_summary($title, &$order, $editable_items=false)
        $k = 0;  //row colour counter
 
        $id = find_submit('Edit');
-
        foreach ($order->line_items as $line_no=>$stock_item)
        {
 
@@ -117,7 +111,7 @@ function display_order_summary($title, &$order, $editable_items=false)
                        qty_cell($stock_item->qty_dispatched);
 
                        if ($order->trans_no!=0)
-                       amount_cell($stock_item->qty_done);
+                               amount_cell($stock_item->qty_done);
 
                        label_cell($stock_item->units);
                        amount_cell($stock_item->price);
@@ -127,8 +121,10 @@ function display_order_summary($title, &$order, $editable_items=false)
 
                        if ($editable_items)
                        {
-                               edit_button_cell("Edit$line_no", _("Edit"));
-                               edit_button_cell("Delete$line_no", _("Delete"));
+                               edit_button_cell("Edit$line_no", _("Edit"),
+                               _('Edit document line'));
+                               edit_button_cell("Delete$line_no", _("Delete"),
+                               _('Remove line from document'));
                        }
                        end_row();
                }
@@ -136,7 +132,7 @@ function display_order_summary($title, &$order, $editable_items=false)
                {
                        sales_order_item_controls($order, $k,  $line_no);
                }
-
+               
                $total += $line_total;
        }
 
@@ -148,19 +144,23 @@ function display_order_summary($title, &$order, $editable_items=false)
                "nowrap align=right", 2);
 
        end_table();
+    div_end();
 }
 
 // ------------------------------------------------------------------------------
 
 function display_order_header(&$order, $editable, $date_text, $display_tax_group=false)
 {
-       global $table_style;
+       global $table_style, $Ajax;
+
        start_table("width=80% $table_style");
        echo "<tr><td valign=top>"; // outer table
        echo "<table>";
 
        $customer_error = "";
        $change_prices = 0;
+       $newcust = ($order->customer_id != get_post('customer_id', -1));
+       $newbranch = ($order->Branch != get_post('branch_id', -1)) || $newcust;
 
        if (isset($order) && !$editable)
        {
@@ -172,68 +172,60 @@ function display_order_header(&$order, $editable, $date_text, $display_tax_group
        }
        else
        {
-
-               if (!isset($_POST['customer_id']) && (get_global_customer() != reserved_words::get_all()))
-                               $_POST['customer_id'] = get_global_customer();
-
                customer_list_row(_("Customer:"), 'customer_id', null, false, true);
 
-               if (!isset($_POST['delivery_date']))
-               {
-                       if ($order->trans_type==10)
-                               $_POST['delivery_date'] = $_SESSION['Items']->due_date =
-                                       get_invoice_duedate($_POST['customer_id'], $_POST['OrderDate']);
-                       else
-                               $_POST['delivery_date'] = $_SESSION['Items']->due_date =
-                                       add_days($_POST['OrderDate'], 10); // FIX this should be in company prefs
-               }
-               if ($order->customer_id != $_POST['customer_id'])
+               if ($newcust)
                {
                        // customer has changed
                        // clear the branch selection
-                       unset($_POST['branch_id']);
-               }
-               if (!isset($_POST['branch_id']))
-                       $_POST['branch_id'] = "";
-
-               customer_branches_list_row(_("Branch:"), $_POST['customer_id'], 'branch_id', null, false, true, true);
+                       $_POST['branch_id'] = '';
+                       $Ajax->activate('branch_id');
+               }
+               customer_branches_list_row(_("Branch:"), 
+                 $_POST['customer_id'], 'branch_id', null, false, true, true);
 
                if (!isset($_POST['branch_id']) || $_POST['branch_id'] == "")
                {
-                       $customer_error = _("The selected customer does not have any branches. Please create at least one branch.");
-                       unset($_POST['branch_id']);
-                       $order->Branch = 0;
+                       // ignore errors on customer search box call
+                       if ($_POST['customer_id'] == '')
+                           $customer_error = _("No customer found for entered text.");
+                       else
+                           $customer_error = _("The selected customer does not have any branches. Please create at least one branch.");
+                   unset($_POST['branch_id']);
+                   $order->Branch = 0;
                } else
                {
-                       //set_global_customer($_POST['customer_id']);
-                       if (($order->customer_id != $_POST['customer_id']) ||
-                               ($order->Branch != $_POST['branch_id'])) {
-
+                       if($newcust || $newbranch) {
                                $old_order = (PHP_VERSION<5) ? $order : clone( $order );
                                $customer_error = get_customer_details_to_order($order, $_POST['customer_id'], $_POST['branch_id']);
+
                                $_POST['Location'] = $order->Location;
                                $_POST['deliver_to'] = $order->deliver_to;
                                $_POST['delivery_address'] = $order->delivery_address;
                                $_POST['phone'] = $order->phone;
-                               $_POST['sales_type'] = $order->sales_type;
-                               $_POST['factor'] = $order->price_factor;
-
+                               $Ajax->activate('Location');
+                               $Ajax->activate('deliver_to');
+                               $Ajax->activate('phone');
+                               $Ajax->activate('delivery_address');
                                // change prices if necessary
                                // what about discount in template case?
-                               if ( $old_order->customer_currency!=$order->customer_currency
-                                       || $old_order->sales_type!=$order->sales_type
+                               if ($old_order->customer_currency != $order->customer_currency) {
+                                   $change_prices = 1;
+                               }
+                               if ($old_order->sales_type != $order->sales_type) {
                                //  || $old_order->default_discount!=$order->default_discount
-                                       ) {
-                                       $change_prices = 1;
+                                       $_POST['sales_type'] = $order->sales_type;
+                                   $Ajax->activate('sales_type');
+                                   $change_prices = 1;
                                }
-
+                               unset($old_order);
                        }
                } // changed branch
                set_global_customer($_POST['customer_id']);
        }
 
        if ($_SESSION['Items']->trans_type!=30) {
-               ref_cells(_("Reference").':', 'ref', null, '');
+               ref_cells(_("Reference").':', 'ref', _('Reference number unique for this document type'), null, '');
        }
 
        echo "</table>";
@@ -242,18 +234,28 @@ function display_order_header(&$order, $editable, $date_text, $display_tax_group
 
        if (!is_company_currency($order->customer_currency))
        {
+           div_start('currency');
                echo "<table height='5'>";
                label_row(_("Customer Currency:"), $order->customer_currency);
                exchange_rate_display($order->customer_currency, get_company_currency(),
                        ($editable ? $_POST['OrderDate'] : $order->document_date), $editable);
                echo "</table>";
+           div_end();
                echo "</td><td>"; // outer table
        }
 
+
+       echo "<table height='5'>";
+       if($editable) {
+               $str = sales_types_list_row(_("Price List"), 'sales_type', null, true);
+       } else {
+               label_row(_("Price List:"), $order->sales_type_name);
+       }
        if ($order->sales_type != $_POST['sales_type']) {
                $myrow = get_sales_type($_POST['sales_type']);
                $order->set_sales_type($myrow['id'], $myrow['sales_type'],
                $myrow['tax_included'], $myrow['factor']);
+               $Ajax->activate('sales_type');
                $change_prices = 1;
        }
 
@@ -264,13 +266,7 @@ function display_order_header(&$order, $editable, $date_text, $display_tax_group
                                $order->sales_type, $order->price_factor, $order->document_date);
                //              $line->discount_percent = $order->default_discount;
                }
-       }
-
-       echo "<table height='5'>";
-       if($editable)
-               sales_types_list_row(_("Price List"), 'sales_type', $_POST['sales_type'], true);
-       else {
-               label_row(_("Price List:"), $order->sales_type_name);
+           $Ajax->activate('items_table');
        }
        label_row(_("Customer Discount:"), ($order->default_discount * 100) . "%");
        echo "</table>";
@@ -284,7 +280,8 @@ function display_order_header(&$order, $editable, $date_text, $display_tax_group
                if (!isset($_POST['OrderDate']) || $_POST['OrderDate'] == "")
                        $_POST['OrderDate'] = $order->document_date;
 
-               date_row($date_text, 'OrderDate');
+               date_row($date_text, 'OrderDate',
+                 _('Date of order receive'));
        }
        else
        {
@@ -310,6 +307,8 @@ function display_order_header(&$order, $editable, $date_text, $display_tax_group
 
 function sales_order_item_controls(&$order, &$rowcounter, $line_no=-1)
 {
+    global $Ajax;
+
        alt_table_row_color($rowcounter);
 
        $id = find_submit('Edit');
@@ -319,34 +318,32 @@ function sales_order_item_controls(&$order, &$rowcounter, $line_no=-1)
                $_POST['qty'] = qty_format($order->line_items[$id]->qty_dispatched);
                $_POST['price'] = price_format($order->line_items[$id]->price);
                $_POST['Disc'] = percent_format($order->line_items[$id]->discount_percent*100);
-               $_POST['units'] = $order->line_items[$id]->units;
+               $units = $order->line_items[$id]->units;
                hidden('stock_id', $_POST['stock_id']);
                label_cell($_POST['stock_id']);
                label_cell($order->line_items[$line_no]->item_description, "nowrap");
+           $Ajax->activate('items_table');
        }
        else
        {
-
-               if (get_company_pref('no_item_list'))
-               {
-                       echo "<td colspan=2 nowrap>\n";
-                       stock_items_list('stock_id', null, false, true);
-                       echo "</td>\n";
-               }
-               else
-               {
-               text_cells(null, "StockID2", '', 12, 10, "", "", "class='combo' rel='stock_id'"/* onblur='this.form.submit();'"*/);
-               stock_items_list_cells(null, 'stock_id', null, false, true, "class='combo' rel='StockID2'");
+               stock_items_list_cells(null,'stock_id', null, false, true);
+               if(isset($_POST['_stock_id_update'])) {
+                           $Ajax->activate('price');
+                           $Ajax->activate('units');
+                           $Ajax->activate('line_total');
                }
+
                $item_info = get_item_edit_info($_POST['stock_id']);
-               $_POST['units'] = $item_info["units"];
+               $units = $item_info["units"];
 
                $_POST['qty'] = qty_format(1);
+
                $_POST['price'] = price_format(get_price ($_POST['stock_id'],
                        $order->customer_currency, $order->sales_type, 
                        $order->price_factor, $order->document_date));
                // default to the customer's discount %
                $_POST['Disc'] = percent_format($order->default_discount * 100);
+
        }
 
        qty_cells(null, 'qty', qty_format($_POST['qty']));
@@ -355,23 +352,30 @@ function sales_order_item_controls(&$order, &$rowcounter, $line_no=-1)
                amount_cell($line_no==-1 ? 0 :$order->line_items[$line_no]->qty_done);
        }
 
-       label_cell($_POST['units']);
-       amount_cells(null, 'price');
+       label_cell($units, '', 'units');
+
+       $str = amount_cells(null, 'price');
+       
        small_amount_cells(null, 'Disc', percent_format($_POST['Disc']), null, null, user_percent_dec());
 
        $line_total = $_POST['qty'] * $_POST['price'] * (1 - $_POST['Disc'] / 100);
-       amount_cell($line_total);
+
+       amount_cell($line_total, false, '','line_total');
 
        if ($id!=-1)
        {
-               edit_button_cell('UpdateItem', _("Update"));
-               edit_button_cell('CancelItemChanges', _("Cancel"));
+               edit_button_cell('UpdateItem', _("Update"),
+                               _('Confirm changes'));
+               edit_button_cell('CancelItemChanges', _("Cancel"),
+                               _('Cancel changes'));
                hidden('LineNo', $line_no);
                set_focus('qty');
+               $Ajax->addFocus(true, 'qty');
        }
        else
        {
-               submit_cells('AddItem', _("Add Item"), "colspan=2");
+               submit_cells('AddItem', _("Add Item"), "colspan=2", 
+                   _('Add new item to document'), true);
        }
 
        end_row();
@@ -404,16 +408,18 @@ function display_delivery_details(&$order)
 
        echo "<table>";
 
-//     echo $order->Location, $_POST['Location'];
-
-       locations_list_row(_("Deliver from Location:"), 'Location', $_POST['Location']);
+       locations_list_row(_("Deliver from Location:"), 'Location', $order->Location);
 
-       date_row($delname, 'delivery_date', $order->due_date, 0, 0, 0);
+       date_row($delname, 'delivery_date', 
+           _('Enter requested day of delivery'), $order->due_date, 0, 0, 0);
 
-       text_row(_("Deliver To:"), 'deliver_to', $order->deliver_to, 40, 40);
+       text_row(_("Deliver To:"), 'deliver_to', $order->deliver_to, 40, 40,
+       _('Additional identifier for delivery e.g. name of receiving person'));
 
-       textarea_row(_("Address:"), 'delivery_address', $order->delivery_address, 35, 5);
-       text_row(_("Contact Phone Number:"), 'phone', $order->phone, 25, 25);
+       textarea_row(_("Address:"), 'delivery_address', $order->delivery_address, 35, 5,
+       _('Delivery address. Default is address of customer branch'));
+       text_row(_("Contact Phone Number:"), 'phone', $order->phone, 25, 25,
+           _('Phone number of ordering person. Defaults to branch phone number'));
 
        echo "</table>";
 
@@ -421,11 +427,12 @@ function display_delivery_details(&$order)
 
        echo "<table>";
 
-       text_row(_("Customer Reference:"), 'cust_ref', $order->cust_ref, 25, 25);
+       text_row(_("Customer Reference:"), 'cust_ref', $order->cust_ref, 25, 25,
+         _('Customer reference number for this order (if any)'));
        textarea_row(_("Comments:"), "Comments", $order->Comments, 31, 5);
 
        small_amount_row(_("Shipping Charge:"), 'freight_cost',
-           price_format($_POST['freight_cost']));
+           price_format(get_post('freight_cost',0)));
 
        shippers_list_row(_("Shipping Company:"), 'ship_via', $order->ship_via);
 
index 25d381a4004561b7b8916f48b0f328e8a0e9fa78..6c82c0987c389aced16347fccdaea9733a6129d9 100644 (file)
@@ -18,9 +18,11 @@ include_once($path_to_root . "/sales/includes/db/sales_types_db.inc");
 include_once($path_to_root . "/reporting/includes/reporting.inc");
 
 $js = '';
+
 if ($use_popup_windows) {
        $js .= get_js_open_window(900, 500);
 }
+
 if ($use_date_picker) {
        $js .= get_js_date_picker();
 }
@@ -48,7 +50,6 @@ if (isset($_GET['NewDelivery']) && is_numeric($_GET['NewDelivery'])) {
 }
 
 page($_SESSION['page_title'], false, false, "", $js);
-
 //-----------------------------------------------------------------------------
 
 if (isset($_GET['AddedID'])) {
@@ -178,13 +179,18 @@ function copy_from_cart()
        $_POST['ship_via'] = $cart->ship_via;
 
        $_POST['customer_id'] = $cart->customer_id;
+
        $_POST['branch_id'] = $cart->Branch;
        $_POST['sales_type'] = $cart->sales_type;
 }
 //--------------------------------------------------------------------------------
 
 function line_start_focus() {
-  set_focus(get_company_pref('no_supplier_list') ? 'stock_id_edit' : 'StockID2');
+  global       $Ajax;
+  
+  $Ajax->activate('items_table');
+  $Ajax->addFocus(true, '_stock_id_edit');
+  set_focus('_stock_id_edit');
 }
 //--------------------------------------------------------------------------------
 
@@ -238,7 +244,6 @@ function can_process() {
                set_focus('ref');
                return false;
        }
-
        return true;
 }
 
@@ -308,7 +313,7 @@ function handle_update_item()
 function handle_delete_item($line_no)
 {
     if ($_SESSION['Items']->some_already_delivered($line_no) == 0) {
-       $_SESSION['Items']->remove_from_cart($line_no);
+           $_SESSION['Items']->remove_from_cart($line_no);
     } else {
        display_error(_("This item cannot be deleted because some of it has already been delivered."));
     }
@@ -319,13 +324,13 @@ function handle_delete_item($line_no)
 
 function handle_new_item()
 {
+  
        if (!check_item_data()) {
                        return;
        }
        add_to_order($_SESSION['Items'], $_POST['stock_id'], input_num('qty'),
                input_num('price'), input_num('Disc') / 100);
-
-       $_POST['StockID2'] = $_POST['stock_id'] = "";
+       $_POST['_stock_id_edit'] = $_POST['stock_id']   = "";
        line_start_focus();
 }
 
@@ -387,18 +392,13 @@ function create_cart($type, $trans_no)
                        $doc->line_items[$line_no]->qty_done = 0;
                }
                $_SESSION['Items'] = $doc;
-       } else
+       } else 
                $_SESSION['Items'] = new Cart($type,array($trans_no));
-
        copy_from_cart();
 }
 
 //--------------------------------------------------------------------------------
 
-
-//if (isset($_GET['Delete']) || isset($_GET['Edit']))
-//     copy_from_cart(); // GET method need form restore
-
 if (isset($_POST['CancelOrder']))
        handle_cancel_order();
 
@@ -412,11 +412,13 @@ if (isset($_POST['UpdateItem']))
 if (isset($_POST['AddItem']))
        handle_new_item();
 
-if (isset($_POST['CancelItemChanges']) || isset($_POST['UpdateItem']))
+if (isset($_POST['CancelItemChanges']) || isset($_POST['UpdateItem'])) {
        line_start_focus();
+}
 
+if (isset($_POST['_customer_id_update']))
+    set_focus('branch_id');
 //--------------------------------------------------------------------------------
-
 check_db_has_stock_items(_("There are no inventory items defined in the system."));
 
 check_db_has_customer_branches(_("There are no customers, or there are no customers with branches. Please define customers and customer branches."));
@@ -457,16 +459,20 @@ if ($customer_error == "") {
        end_table(1);
 
        if ($_SESSION['Items']->trans_no == 0) {
-               submit_center_first('ProcessOrder', $porder);
+
+               submit_center_first('ProcessOrder', $porder,
+                   _('Check entered data and save document'), true);
        } else {
-               submit_center_first('ProcessOrder', $corder);
+               submit_center_first('ProcessOrder', $corder,
+                   _('Validate changes and update document'), true);
        }
 
-       submit_center_last('CancelOrder', $cancelorder);
+       submit_center_last('CancelOrder', $cancelorder, 
+          _('Cancels document entry or removes sales order when editing an old document'));
 } else {
        display_error($customer_error);
 }
 end_form();
-//--------------------------------------------------------------------------------
 end_page();
+
 ?>
\ No newline at end of file