purchasing/includes/ui/invoice_ui.inc

   1 <?php
   2 /**********************************************************************
   3     Copyright (C) FrontAccounting, LLC.
   4         Released under the terms of the GNU General Public License, GPL,
   5         as published by the Free Software Foundation, either version 3
   6         of the License, or (at your option) any later version.
   7     This program is distributed in the hope that it will be useful,
   8     but WITHOUT ANY WARRANTY; without even the implied warranty of
   9     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
  10     See the License here <http://www.gnu.org/licenses/gpl-3.0.html>.
  11 ***********************************************************************/
  12 //--------------------------------------------------------------------------------------------------
  13
  14 function copy_from_trans(&$supp_trans)
  15 {
  16         $_POST['Comments'] = $supp_trans->Comments;
  17         $_POST['tran_date'] = $supp_trans->tran_date;
  18         $_POST['due_date'] = $supp_trans->due_date;
  19         $_POST['supp_reference'] = $supp_trans->supp_reference;
  20         $_POST['reference'] = $supp_trans->reference;
  21         $_POST['supplier_id'] = $supp_trans->supplier_id;
  22 }
  23
  24 //--------------------------------------------------------------------------------------------------
  25
  26 function copy_to_trans(&$supp_trans)
  27 {
  28         $supp_trans->Comments = $_POST['Comments'];
  29         $supp_trans->tran_date = $_POST['tran_date'];
  30         $supp_trans->due_date = $_POST['due_date'];
  31         $supp_trans->supp_reference = $_POST['supp_reference'];
  32         $supp_trans->reference = $_POST['reference'];
  33
  34         $supp_trans->ov_amount = 0; /* for starters */
  35         if (count($supp_trans->grn_items) > 0)
  36         {
  37                 foreach ( $supp_trans->grn_items as $grn)
  38                 {
  39                         $supp_trans->ov_amount += round2(($grn->this_quantity_inv * $grn->chg_price),
  40                           user_price_dec());
  41                 }
  42         }
  43         if (count($supp_trans->gl_codes) > 0)
  44         {
  45                 foreach ( $supp_trans->gl_codes as $gl_line)
  46                 {
  47                         ////////// 2009-08-18 Joe Hunt
  48                         if (!is_tax_account($gl_line->gl_code))
  49                                 $supp_trans->ov_amount += $gl_line->amount;
  50                 }
  51         }
  52 }
  53
  54 //--------------------------------------------------------------------------------------------------
  55
  56 function invoice_header(&$supp_trans)
  57 {
  58         global $Ajax, $table_style2, $Refs;
  59
  60         // if vars have been lost, recopy
  61         if (!isset($_POST['tran_date']))
  62                 copy_from_trans($supp_trans);
  63
  64         start_outer_table("width=95% $table_style2");
  65
  66         table_section(1);
  67
  68         if (isset($_POST['invoice_no']))
  69         {
  70                 $trans = get_supp_trans($_POST['invoice_no'], ST_SUPPINVOICE);
  71                 $_POST['supplier_id'] = $trans['supplier_id'];
  72                 $supp = $trans['supplier_name'] . " - " . $trans['SupplierCurrCode'];
  73                 label_row(_("Supplier:"), $supp.hidden('supplier_id', $_POST['supplier_id'], false));
  74         }
  75         else
  76         {
  77         if (!isset($_POST['supplier_id']) && (get_global_supplier() != ALL_TEXT))
  78                 $_POST['supplier_id'] = get_global_supplier();
  79
  80                 supplier_list_row(_("Supplier:"), 'supplier_id', $_POST['supplier_id'], false, true);
  81         }
  82         if ($supp_trans->supplier_id != $_POST['supplier_id'])
  83         {
  84                 // supplier has changed
  85                 // delete all the order items - drastic but necessary because of
  86                 // change of currency, etc
  87                 $supp_trans->clear_items();
  88                 read_supplier_details_to_trans($supp_trans, $_POST['supplier_id']);
  89                 copy_from_trans($supp_trans);
  90         }
  91
  92         if ($supp_trans->is_invoice)
  93         ref_row(_("Reference:"), 'reference', '', $Refs->get_next(ST_SUPPINVOICE));
  94     else
  95         ref_row(_("Reference:"), 'reference', '', $Refs->get_next(ST_SUPPCREDIT));
  96
  97         if (isset($_POST['invoice_no']))
  98         {
  99                 label_row(_("Supplier's Ref.:"), $_POST['invoice_no'].hidden('invoice_no', $_POST['invoice_no'], false).hidden('supp_reference', $_POST['invoice_no'], false));
 100         }
 101         else
 102                 text_row(_("Supplier's Ref.:"), 'supp_reference', $_POST['supp_reference'], 20, 20);
 103
 104         table_section(2, "33%");
 105
 106         date_row(_("Date") . ":", 'tran_date', '', true, 0, 0, 0, "", true);
 107         if (isset($_POST['_tran_date_changed'])) {
 108                 $Ajax->activate('_ex_rate');
 109                 $supp_trans->tran_date = $_POST['tran_date'];
 110                 get_duedate_from_terms($supp_trans);
 111                 $_POST['due_date'] = $supp_trans->due_date;
 112                 $Ajax->activate('due_date');
 113         }
 114
 115     date_row(_("Due Date") . ":", 'due_date');
 116
 117     label_row(_("Terms:"), $supp_trans->terms_description);
 118
 119         table_section(3, "33%");
 120
 121         set_global_supplier($_POST['supplier_id']);
 122
 123         $supplier_currency = get_supplier_currency($supp_trans->supplier_id);
 124
 125         $company_currency = get_company_currency();
 126
 127         if ($supplier_currency != $company_currency)
 128         {
 129         label_row(_("Supplier's Currency:"), "<b>" . $supplier_currency . "</b>");
 130                 exchange_rate_display($supplier_currency, $company_currency, $_POST['tran_date']);
 131         }
 132
 133         label_row(_("Tax Group:"), $supp_trans->tax_description);
 134
 135         end_outer_table(1);
 136 }
 137
 138 //--------------------------------------------------------------------------------------------------
 139
 140 function invoice_totals(&$supp_trans)
 141 {
 142         global $table_style, $table_style2;
 143
 144         copy_to_trans($supp_trans);
 145
 146         $dim = get_company_pref('use_dimension');
 147         $colspan = ($dim == 2 ? 7 : ($dim == 1 ? 6 : 5));
 148         start_table("$table_style width=95%");
 149         label_row(_("Sub-total:"), price_format( $supp_trans->ov_amount), "colspan=$colspan align=right", "align=right");
 150
 151     $taxes = $supp_trans->get_taxes($supp_trans->tax_group_id);
 152     $tax_total = display_edit_tax_items($taxes, $colspan, 0); // tax_included==0 (we are the company)
 153
 154     $display_total = price_format($supp_trans->ov_amount + $tax_total);
 155
 156         if ($supp_trans->is_invoice)
 157         label_row(_("Invoice Total:"), $display_total, "colspan=$colspan align=right style='font-weight:bold;'", "align=right style='font-weight:bold;'");
 158     else
 159                 label_row(_("Credit Note Total"),
 160                         $display_total, "colspan=$colspan align=right style='font-weight:bold;color:red;'", "nowrap align=right style='font-weight:bold;color:red;'");
 161
 162     end_table(1);
 163     start_table($table_style2);
 164     textarea_row(_("Memo:"), "Comments", null, 50, 3);
 165     end_table(1);
 166 }
 167
 168 //--------------------------------------------------------------------------------------------------
 169 function display_gl_controls(&$supp_trans, $k)
 170 {
 171         global $table_style, $table_style2;
 172
 173         $accs = get_supplier_accounts($supp_trans->supplier_id);
 174         $_POST['gl_code'] = $accs['purchase_account'];
 175
 176         alt_table_row_color($k);
 177         echo gl_all_accounts_list('gl_code', null, true, true);
 178         $dim = get_company_pref('use_dimension');
 179         if ($dim >= 1)
 180                 dimensions_list_cells(null, 'dimension_id', null, true, " ", false, 1);
 181         if ($dim > 1)
 182                 dimensions_list_cells(null, 'dimension2_id', null, true, " ", false, 2);
 183         amount_cells(null, 'amount');
 184         if ($dim < 1)
 185                 text_cells_ex(null, 'memo_', 35, 50, null, null, null, hidden('dimension_id', 0, false).hidden('dimension2_id', 0, false));
 186         else if ($dim < 2)
 187                 text_cells_ex(null, 'memo_', 35, 50, null, null, null, hidden('dimension2_id', 0, false));
 188         else
 189                 text_cells_ex(null, 'memo_', 35, 50, null, null, null);
 190         submit_cells('AddGLCodeToTrans', _("Add"), "",
 191                     _('Add GL Line'), true);
 192         submit_cells('ClearFields', _("Reset"), "",
 193                     _("Clear all GL entry fields"), true);
 194         end_row();
 195 }
 196
 197 // $mode = 0 none at the moment
 198 //               = 1 display on invoice/credit page
 199 //               = 2 display on view invoice
 200 //               = 3 display on view credit
 201
 202 function display_gl_items(&$supp_trans, $mode=0)
 203 {
 204         global $table_style, $table_style2, $path_to_root, $Ajax;
 205
 206     // if displaying in form, and no items, exit
 207     if (($mode == 2 || $mode == 3) && count($supp_trans->gl_codes) == 0)
 208         return 0;
 209
 210         if ($supp_trans->is_invoice)
 211                 $heading = _("GL Items for this Invoice");
 212         else
 213                 $heading = _("GL Items for this Credit Note");
 214
 215         start_outer_table("$table_style width=95%");
 216
 217         if ($mode == 1)
 218         {
 219                 $qes = has_quick_entries(QE_SUPPINV);
 220                 if ($qes !== false)
 221                 {
 222                         echo "<div style='float:right;'>";
 223                         echo _("Quick Entry:")."&nbsp;";
 224                         echo quick_entries_list('qid', null, QE_SUPPINV, true);
 225                         $qid = get_quick_entry(get_post('qid'));
 226                         if (list_updated('qid')) {
 227                                 unset($_POST['totamount']); // enable default
 228                                 $Ajax->activate('totamount');
 229                         }
 230                         echo "&nbsp;".$qid['base_desc'].":"."&nbsp;";
 231
 232                         $amount = input_num('totamount', $qid['base_amount']);
 233                         $dec = user_price_dec();
 234                         echo "<input class='amount' type='text' name='totamount' size='7' maxlength='12' dec='$dec' value='$amount'>&nbsp;";
 235                         submit('go', _("Go"), true, false, true);
 236                         echo "</div>";
 237
 238                 }
 239         }
 240         display_heading($heading);
 241
 242         end_outer_table(0, false);
 243
 244         div_start('gl_items');
 245         start_table("$table_style width=95%");
 246
 247         $dim = get_company_pref('use_dimension');
 248         if ($dim == 2)
 249         $th = array(_("Account"), _("Name"), _("Dimension")." 1", _("Dimension")." 2", _("Amount"), _("Memo"));
 250         else if ($dim == 1)
 251         $th = array(_("Account"), _("Name"), _("Dimension"), _("Amount"), _("Memo"));
 252     else
 253         $th = array(_("Account"), _("Name"), _("Amount"), _("Memo"));
 254
 255         if ($mode == 1)
 256         {
 257                 $th[] = "";
 258                 $th[] = "";
 259         }
 260         table_header($th);
 261         $total_gl_value=0;
 262         $i = $k = 0;
 263
 264         if (count($supp_trans->gl_codes) > 0)
 265         {
 266
 267                 foreach ($supp_trans->gl_codes as $entered_gl_code)
 268                 {
 269
 270                         alt_table_row_color($k);
 271
 272                         if ($mode == 3)
 273                                 $entered_gl_code->amount = -$entered_gl_code->amount;
 274
 275                         label_cell($entered_gl_code->gl_code);
 276                         label_cell($entered_gl_code->gl_act_name);
 277
 278                         if ($dim >= 1)
 279                                 label_cell(get_dimension_string($entered_gl_code->gl_dim, true));
 280                         if ($dim > 1)
 281                                 label_cell(get_dimension_string($entered_gl_code->gl_dim2, true));
 282
 283                         amount_cell($entered_gl_code->amount, true);
 284                         label_cell($entered_gl_code->memo_);
 285
 286                         if ($mode == 1)
 287                         {
 288                                 delete_button_cell("Delete2" . $entered_gl_code->Counter, _("Delete"),
 289                                           _('Remove line from document'));
 290                                 label_cell("");
 291                         }
 292                         end_row();
 293                         /////////// 2009-08-18 Joe Hunt
 294                         if ($mode > 1 && !is_tax_account($entered_gl_code->gl_code))
 295                                 $total_gl_value += $entered_gl_code->amount;
 296                         else
 297                                 $total_gl_value += $entered_gl_code->amount;
 298                         $i++;
 299                         if ($i > 15)
 300                         {
 301                                 $i = 0;
 302                                 table_header($th);
 303                         }
 304                 }
 305
 306         }
 307         if ($mode == 1)
 308                 display_gl_controls($supp_trans, $k);
 309         $colspan = ($dim == 2 ? 4 : ($dim == 1 ? 3 : 2));
 310         label_row(_("Total"), price_format($total_gl_value),
 311                 "colspan=".$colspan." align=right", "nowrap align=right", ($mode==1?3:1));
 312
 313         end_table(1);
 314         div_end();
 315
 316         return $total_gl_value;
 317 }
 318
 319 //--------------//-----------------------------------------------------------------------------------------
 320
 321 function display_grn_items_for_selection(&$supp_trans, $k)
 322 {
 323         global $table_style;
 324
 325         if ($supp_trans->is_invoice)
 326                 $result = get_grn_items(0, $supp_trans->supplier_id, true);
 327         else
 328         {
 329                 if (isset($_POST['receive_begin']) && isset($_POST['receive_end']))
 330                         $result = get_grn_items(0, $supp_trans->supplier_id, false, true, 0, $_POST['receive_begin'], $_POST['receive_end']);
 331                 else if (isset($_POST['invoice_no']))
 332                         $result = get_grn_items(0, $supp_trans->supplier_id, false, true, $_POST['invoice_no']);
 333                 else
 334                         $result = get_grn_items(0, $supp_trans->supplier_id, false, true);
 335         }
 336     if (db_num_rows($result) == 0)
 337     {
 338         return false;
 339     }
 340
 341     /*Set up a table to show the outstanding GRN items for selection */
 342
 343     while ($myrow = db_fetch($result))
 344     {
 345                 $grn_already_on_invoice = false;
 346
 347         foreach ($supp_trans->grn_items as $entered_grn)
 348         {
 349                 if ($entered_grn->id == $myrow["id"])
 350                 {
 351                         $grn_already_on_invoice = true;
 352                 }
 353         }
 354         if ($grn_already_on_invoice == false)
 355         {
 356
 357                         alt_table_row_color($k);
 358
 359                         $n = $myrow["id"];
 360                 label_cell(get_trans_view_str(25, $myrow["grn_batch_id"]));
 361                 label_cell($myrow["id"].
 362                 hidden('qty_recd'.$n, $myrow["qty_recd"], false).
 363                 hidden('item_code'.$n, $myrow["item_code"], false).
 364                 hidden('item_description'.$n, $myrow["description"], false).
 365                 hidden('prev_quantity_inv'.$n, $myrow['quantity_inv'], false).
 366                 hidden('order_price'.$n, $myrow['unit_price'], false).
 367                 hidden('std_cost_unit'.$n, $myrow['std_cost_unit'], false).
 368                 hidden('po_detail_item'.$n, $myrow['po_detail_item'], false));
 369                 label_cell(get_trans_view_str(ST_PURCHORDER, $myrow["purch_order_no"]));
 370             label_cell($myrow["item_code"]);
 371             label_cell($myrow["description"]);
 372             label_cell(sql2date($myrow["delivery_date"]));
 373             $dec = get_qty_dec($myrow["item_code"]);
 374             qty_cell($myrow["qty_recd"], false, $dec);
 375             qty_cell($myrow["quantity_inv"], false, $dec);
 376             if ($supp_trans->is_invoice)
 377                 qty_cells(null, 'this_quantity_inv'.$n, number_format2($myrow["qty_recd"] - $myrow["quantity_inv"], $dec),
 378                         null, null, $dec);
 379             else
 380                 qty_cells(null, 'This_QuantityCredited'.$n, number_format2(max($myrow["quantity_inv"], 0), $dec),
 381                         null, null, $dec);
 382             $dec2 = 0;
 383             amount_cells(null, 'ChgPrice'.$n, price_decimal_format($myrow["unit_price"], $dec2), null, null, $dec2);
 384             if ($supp_trans->is_invoice)
 385                 amount_cell(round2($myrow["unit_price"] * ($myrow["qty_recd"] - $myrow["quantity_inv"]), user_price_dec()));
 386             else
 387                 amount_cell(round2($myrow["unit_price"] * max($myrow['quantity_inv'], 0), user_price_dec()));
 388             if ($supp_trans->is_invoice)
 389                         submit_cells('grn_item_id'.$n, _("Add"), '', _("Add to Invoice"), true);
 390                 else
 391                         submit_cells('grn_item_id'.$n, _("Add"), '', _("Add to Credit Note"), true);
 392                 if ($supp_trans->is_invoice && $_SESSION["wa_current_user"]->can_access('SA_GRNDELETE')) {      // Added 2008-10-18 by Joe Hunt. Special access rights needed.
 393                         submit_cells('void_item_id'.$n, _("Remove"), '', _("WARNING! Be careful with removal. The operation is executed immediately and cannot be undone !!!"), true);
 394                                 submit_js_confirm('void_item_id'.$n,
 395                                         sprintf(_('You are about to remove all yet non-invoiced items from delivery line #%d. This operation also irreversibly changes related order line. Do you want to continue ?'), $n));
 396                         }
 397                         end_row();
 398         }
 399     }
 400     return true;
 401 }
 402
 403 //------------------------------------------------------------------------------------
 404
 405 // $mode = 0 none at the moment
 406 //               = 1 display on invoice/credit page
 407 //               = 2 display on view invoice
 408 //               = 3 display on view credit
 409
 410 function display_grn_items(&$supp_trans, $mode=0)
 411 {
 412         global $table_style, $path_to_root;
 413
 414     $ret = true;
 415     // if displaying in form, and no items, exit
 416     if (($mode == 2  || $mode == 3) && count($supp_trans->grn_items) == 0)
 417         return 0;
 418
 419         start_outer_table("style='border:1px solid #cccccc;' width=95%");
 420
 421         $heading2 = "";
 422         if ($mode == 1)
 423         {
 424                 if ($supp_trans->is_invoice)
 425                 {
 426                         $heading = _("Items Received Yet to be Invoiced");
 427                 if ($_SESSION["wa_current_user"]->can_access('SA_GRNDELETE'))   // Added 2008-10-18 by Joe Hunt. Only admins can remove GRNs
 428                                 $heading2 = _("WARNING! Be careful with removal. The operation is executed immediately and cannot be undone !!!");
 429                 }
 430                 else
 431                         $heading = _("Delivery Item Selected For Adding To A Supplier Credit Note");
 432         }
 433         else
 434         {
 435                 if ($supp_trans->is_invoice)
 436                         $heading = _("Received Items Charged on this Invoice");
 437                 else
 438                         $heading = _("Received Items Credited on this Note");
 439         }
 440
 441         display_heading($heading);
 442
 443         if ($mode == 1)
 444         {
 445                 if (!$supp_trans->is_invoice && !isset($_POST['invoice_no']))
 446                 {
 447                         echo "</td>";
 448                         date_cells(_("Received between"), 'receive_begin', "", null, -30, 0, 0, "valign=middle");
 449                         date_cells(_("and"), 'receive_end', '', null, 1, 0, 0, "valign=middle");
 450                         submit_cells('RefreshInquiry', _("Search"),'',_('Refresh Inquiry'), true);
 451                         echo "<td>";
 452                 }
 453
 454                 if ($heading2 != "")
 455                 {
 456                         display_note($heading2, 0, 0, "class='overduefg'");
 457                 }
 458                 echo "</td><td width=10% align='right'>";
 459                 submit('InvGRNAll', _("Add All Items"), true, false,true);
 460         }
 461
 462         end_outer_table(0, false);
 463
 464         div_start('grn_items');
 465         start_table("$table_style width=95%");
 466         if ($mode == 1)
 467         {
 468         $th = array(_("Delivery"), _("Sequence #"), _("P.O."), _("Item"), _("Description"),
 469                 _("Received On"), _("Quantity Received"), _("Quantity Invoiced"),
 470                 _("Qty Yet To Invoice"), _("Order Price"), _("Total"), "");
 471         if ($supp_trans->is_invoice && $_SESSION["wa_current_user"]->can_access('SA_GRNDELETE'))        // Added 2008-10-18 by Joe Hunt. Only admins can remove GRNs
 472                 $th[] = "";
 473                 if (!$supp_trans->is_invoice)
 474                 {
 475                         $th[8] = _("Qty Yet To Credit");
 476                 }
 477     }
 478     else
 479                 $th = array(_("Delivery"), _("Item"), _("Description"),
 480                         _("Quantity"), _("Price"), _("Line Value"));
 481
 482         table_header($th);
 483     $total_grn_value = 0;
 484     $i = $k = 0;
 485
 486         if (count($supp_trans->grn_items) > 0)
 487         {
 488
 489         foreach ($supp_trans->grn_items as $entered_grn)
 490         {
 491
 492                 alt_table_row_color($k);
 493
 494                         $grn_batch = get_grn_batch_from_item($entered_grn->id);
 495                 label_cell(get_trans_view_str(ST_SUPPRECEIVE,$grn_batch));
 496                 if ($mode == 1)
 497                 {
 498                                 label_cell($entered_grn->id);
 499                                 label_cell(""); // PO
 500                         }
 501                         label_cell($entered_grn->item_code);
 502                         label_cell($entered_grn->item_description);
 503             $dec = get_qty_dec($entered_grn->item_code);
 504             if ($mode == 1)
 505             {
 506                 label_cell("");
 507                                 qty_cell($entered_grn->qty_recd, false, $dec);
 508                                 qty_cell($entered_grn->prev_quantity_inv, false, $dec);
 509             }
 510                         qty_cell(abs($entered_grn->this_quantity_inv), true, $dec);
 511                         amount_decimal_cell($entered_grn->chg_price);
 512                         amount_cell( round2($entered_grn->chg_price * abs($entered_grn->this_quantity_inv), user_price_dec()), true);
 513
 514                         if ($mode == 1)
 515                         {
 516                                 delete_button_cell("Delete" . $entered_grn->id, _("Edit"), _('Edit document line'));
 517                                 if ($supp_trans->is_invoice && $_SESSION["wa_current_user"]->can_access('SA_GRNDELETE'))
 518                                         label_cell("");
 519                         }
 520                         end_row();
 521
 522                 $total_grn_value += round2($entered_grn->chg_price * abs($entered_grn->this_quantity_inv),
 523                            user_price_dec());
 524
 525                 $i++;
 526                 if ($i > 15)
 527                 {
 528                         $i = 0;
 529                         table_header($th);
 530                 }
 531         }
 532     }
 533         if ($mode == 1)
 534         {
 535                 $ret = display_grn_items_for_selection($supp_trans, $k);
 536         $colspan = 10;
 537         }
 538         else
 539                 $colspan = 5;
 540         label_row(_("Total"), price_format($total_grn_value),
 541                 "colspan=$colspan align=right", "nowrap align=right");
 542         if (!$ret)
 543         {
 544                 start_row();
 545                 echo "<td colspan=".($colspan + 1).">";
 546                 if ($supp_trans->is_invoice)
 547                         display_note(_("There are no outstanding items received from this supplier that have not been invoiced by them."), 0, 0);
 548                 else
 549                 {
 550                         display_note(_("There are no received items for the selected supplier that have been invoiced."));
 551                         display_note(_("Credits can only be applied to invoiced items."), 0, 0);
 552                 }
 553                 echo "</td>";
 554                 end_row();
 555         }
 556     end_table(1);
 557     div_end();
 558
 559         return $total_grn_value;
 560 }
 561
 562 //--------------------------------------------------------------------------------------------------
 563 function get_duedate_from_terms(&$supp_trans)
 564 {
 565         if (!is_date($supp_trans->tran_date))
 566         {
 567                 $supp_trans->tran_date = Today();
 568         }
 569         if (substr( $supp_trans->terms, 0, 1) == "1")
 570         { /*Its a day in the following month when due */
 571                 $supp_trans->due_date = add_days(end_month($supp_trans->tran_date), (int) substr( $supp_trans->terms,1));
 572         }
 573         else
 574         { /*Use the Days Before Due to add to the invoice date */
 575                 $supp_trans->due_date = add_days($supp_trans->tran_date, (int) substr( $supp_trans->terms,1));
 576         }
 577 }
 578
 579 //--------------------------------------------------------------------------------------------------
 580
 581 ?>