<h1 class="title">Thai Localization - Thai address data</h1> <p><a class="reference external" href="https://odoo-community.org/page/development-status"><img alt="Alpha" src="https://img.shields.io/badge/maturity-Alpha-red.png" /></a> <a class="reference external" href="http://www.gnu.org/licenses/agpl-3.0-standalone.html"><img alt="License: AGPL-3" src="https://img.shields.io/badge/licence-AGPL--3-blue.png" /></a> <a class="reference external" href="https://github.com/poonlap/odoo-th/tree/14.0/th_address"><img alt="poonlap/odoo-th" src="https://img.shields.io/badge/github-poonlap%2Fodoo--th-lightgray.png?logo=github" /></a></p> <p>โมดูลช่วยนำเข้าข้อมูลตำบล, อำเภอ, จังหวัด, รหัสไปรษณีย์ เป็นภาษาไทย (หรือภาษาอังกฤษ) และตั้งค่าต่างๆให้พร้อมใช้งาน</p> <a name="id1"></a> <h2>สิ่งที่โมดูลนี้ทำ</h2> <ul class="simple"> <li>กรณีที่ภาษาหลักที่ใช้ไม่ใช่ภาษาไทย โมดูลนี้จะเพิ่มภาษาไทยเป็นภาษาที่ 2 และนำเข้าคำแปลภาษาไทยในระบบ.</li> <li>ติดตั้งโมดูล <a class="reference external" href="https://github.com/OCA/partner-contact/tree/14.0/base_location_geonames_import">Base Location Geonames Import</a> ซึ่งโมดูลนี้จะติดตั้งโมดูล <a class="reference external" href="https://github.com/OCA/partner-contact/tree/14.0/base_location">Location management (aka Better ZIP)</a> อีกที</li> <li>ตั้งค่า system parameter <code>geonames.url</code> สำหรับดึงข้อมูล ตำบล, อำเภอ, จังหวัด และรหัสไปรษณีย์ เป็นภาษาไทย. หากต้องการเป็นภาษาอังกฤษ หรือผสมกัน สามารถเปลี่ยนได้ภายหลัง</li> <li>เปลี่ยน form โดยสลับตำแหน่งให้ Location completion ขึ้นมาก่อน street2. เวลาพิมพ์ที่อยู่ ลำดับการกรอกข้อมูลจะเป็นธรรมชาติกว่า คือ บ้านเลขที่, ถนน ใส่ในช่อง street1 ตามด้วย Location completion. ถ้าเลือกตำบลอำเภอเสร็จแล้ว จะกรอกใส่ช่องด้านล่าง ตามลำดับจากด้านบนไปด้านล่าง.</li> <li>ระหว่างติดตั้ง จะนำเข้า (import) ข้อมูล ตำบล, อำเภอ, จังหวัด และรหัสไปรษณีย์ เป็นภาษาไทยอัตโนมัติ. เมื่อติดตั้งโมดูลเสร็จแล้ว ข้อมูลพร้อมใช้งานทันที ลดขั้นตอนการนำเข้าข้อมูลเอง</li> </ul> <div class="figure align-center"> <img alt="ข้อมูลจังหวัด" src="https://raw.githubusercontent.com/poonlap/odoo-th/14.0/th_address/static/description/data_provinces.png" style="width: 80%;" /> </div> <div class="figure align-center"> <img alt="ข้อมูลตำบลและอำเภอ" src="https://raw.githubusercontent.com/poonlap/odoo-th/14.0/th_address/static/description/data_cities.png" style="width: 80%;" /> </div> <div class="figure align-center"> <img alt="ข้อมูลรหัสไปรษณีย์" src="https://raw.githubusercontent.com/poonlap/odoo-th/14.0/th_address/static/description/data_zips.png" style="width: 80%;" /> </div> <ul class="simple"> <li>เวลาใช้ Location completion ค้นหาที่อยู่ (ตำบล, อำเภอ, จังหวัด, รหัสไปรษณีย์) เมื่อเลือกข้อมูลที่ค้นหาได้แล้ว จะใส่ชื่อตำบลในช่อง Street2 และใส่ชื่ออำเภอในช่อง Ciy ให้อัตโนมัติ</li> </ul> <div class="figure align-center"> <img alt="ค้นหา" src="https://raw.githubusercontent.com/poonlap/odoo-th/14.0/th_address/static/description/location_completion_01.png" style="width: 80%;" /> </div> <div class="figure align-center"> <img alt="กรอกข้อมูลแยก" src="https://raw.githubusercontent.com/poonlap/odoo-th/14.0/th_address/static/description/location_completion_02.png" style="width: 80%;" /> </div> <ul class="simple"> <li>เปลี่ยนค่า <code>address_format</code> ให้ใช่้ชื่อ จังหวัด <code>state_name</code> แทน <code>state_id</code> ที่เป็นค่าตั้งต้น</li> <li>ตั้งค่า Vat Label เป็น Tax ID</li> </ul> <div class="figure align-center"> <img alt="address_format และ Vat label" src="https://raw.githubusercontent.com/poonlap/odoo-th/14.0/th_address/static/description/country_setting.png" style="width: 80%;" /> </div> <a name="th-address-docker-image"></a> <h2>ลองใช้งาน th_address จาก docker image</h2> <p>โมดูลนี้รวมไว้ใน <a class="reference external" href="https://github.com/poonlap/odoo-th">docker odoo-th</a> แล้ว สามารถลองใช้ได้ทันที.:</p> <pre> <code>$ git clone https://github.com/poonlap/odoo-th.git $ cd odoo-th/docker $ docker-compose up</code> </pre> <div class="admonition important"> <p class="first admonition-title">Important</p> <p class="last">This is an alpha version, the data model and design can change at any time without warning. Only for development or testing purpose, do not use in production. <a class="reference external" href="https://odoo-community.org/page/development-status">More details on development status</a></p> </div> <p><strong>Table of contents</strong></p> <div class="contents local topic" id="contents"> <ul class="simple"> <li><a class="reference internal" href="#usage" id="id4">Usage</a></li> </ul> </div> <a name="usage"></a> <h3><a class="toc-backref" href="#id4">Usage</a></h3> <a name="contact"></a> <h2>สร้าง Contact หรือลูกค้าใหม่</h2> <p>กรอกชื่อที่อยู่ตามปกติ เมื่อจะเริ่มกรอกตำบลหรือแขวง ให้ไปที่ช่อง &quot;Location completion&quot;</p> <div class="figure align-center"> <img alt="https://raw.githubusercontent.com/poonlap/odoo-th/14.0/th_address/static/description/autocompletion.png" src="https://raw.githubusercontent.com/poonlap/odoo-th/14.0/th_address/static/description/autocompletion.png" style="width: 80%;" /> </div> <p>กรอกคำที่ต้องการค้นหา เช่น ชื่อตำบล หรือ ชื่ออำเภอ หรือ รหัสไปรษณีย์ แล้วเลือกข้อมูลที่ระบบหามาให้. ระบบจะเติมช่อง street2 ให้เป็นตำบล, ช่อง city เป็นอำเภอ, ช่อง state เป็นจังหวัด เติมรหัสไปรษณีย์ให้อัตโนมัติ สามารถป้องกันความผิดพลาดกรณีผู้ใช้กรอกผิดได้</p> <a name="id2"></a> <h2>นำเข้าข้อมูลที่อยู่เป็นภาษาอังกฤษ</h2> <ul> <li><p class="first">เข้า developer mode</p> </li> <li><p class="first">ไปที่ Settings &gt; Technical &gt; System Parameters</p> </li> <li><p class="first">แก้ค่าตัวแปร <code>geonames.url</code> เป็น:</p> <pre> <code>https://github.com/poonlap/odoo-th/raw/14.0/th_address/data/en/%s.zip</code> </pre> </li> <li><p class="first">ไปที่ Contacts &gt; Configuration &gt; Import from Geonames</p> </li> <li><p class="first">เลือก Thailand และกดปุ่ม import</p> </li> </ul> <div class="figure align-center"> <img alt="ข้อมูลภาษาอังกฤษ" src="https://raw.githubusercontent.com/poonlap/odoo-th/14.0/th_address/static/description/data_english.png" style="width: 80%;" /> </div> <ul> <li><p class="first">กรณีที่ต้องการข้อมูลผสม ภาษาไทยและอังกฤษ ให้ตั้งค่า <code>geonames.url</code> เป็น:</p> <pre> <code>https://github.com/poonlap/odoo-th/raw/14.0/th_address/data/th_en/%s.zip</code> </pre> </li> </ul> <div class="figure align-center"> <img alt="ข้อมูลภาษาผสม" src="https://raw.githubusercontent.com/poonlap/odoo-th/14.0/th_address/static/description/data_mix.png" style="width: 80%;" /> </div> <ul class="simple"> <li>ถ้าต้องการนำเข้าข้อมูลที่อยู่ประเทศอื่นๆ ให้ลบ system parameter <code>geonames.url</code> ทิ้ง. แล้วโมดูล <a class="reference external" href="https://github.com/OCA/partner-contact/tree/14.0/base_location_geonames_import">Base Location Geonames Import</a> จะดาวน์โหลดข้อมูลจากแหล่งที่เตรียมไว้ให้เอง.</li> </ul> <a name="bug-tracker"></a> <h3>Bug Tracker</h3> <p>Bugs are tracked on <a class="reference external" href="https://github.com/poonlap/odoo-th/issues">GitHub Issues</a>. In case of trouble, please check there if your issue has already been reported. If you spotted it first, help us smashing it by providing a detailed and welcomed <a class="reference external" href="https://github.com/poonlap/odoo-th/issues/new?body=module:%20th_address%0Aversion:%2014.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**">feedback</a>.</p> <p>Do not contact contributors directly about support or help with technical issues.</p> <a name="credits"></a> <h3>Credits</h3> <a name="authors"></a> <h4>Authors</h4> <ul class="simple"> <li>Poonlap V.</li> </ul> <a name="other-credits"></a> <h4>Other credits</h4> <ul class="simple"> <li><a class="reference external" href="https://github.com/OCA/l10n-thailand/tree/13.0/l10n_th_base_location">l10n_th_base_location</a></li> </ul> <a name="maintainers"></a> <h4>Maintainers</h4> <p>Current maintainer:</p> <p><a class="reference external" href="https://github.com/poonlap"><img alt="poonlap" src="https://github.com/poonlap.png?size=40px" /></a></p> <p>This module is part of the <a class="reference external" href="https://github.com/poonlap/odoo-th/tree/14.0/th_address">poonlap/odoo-th</a> project on GitHub.</p> <p>You are welcome to contribute.</p>