Tích hợp trang web

1. Trước khi bắt đầu

• Gói Pro. Tiện ích tin đăng, nút dành cho cư dân, các nút làm sẵn, mã QR và nguồn dữ liệu thuộc gói RentMerchant Pro. Liên kết thông thường và trang RentMerchant miễn phí của bạn dùng được với mọi gói. Nâng cấp tại Thanh toán gói dịch vụ trong tài khoản của bạn.
• Một địa chỉ email đã xác nhận. Tin đăng và tiện ích chỉ hiển thị cho các tài khoản đã xác minh.
• Quyền chỉnh sửa trang web của bạn. Bạn cần có quyền thêm thành phần trang trong công cụ tạo trang web của mình. Một số công cụ chỉ cho phép mã tùy chỉnh ở gói trả phí; các bước cho từng công cụ tạo trang bên dưới cho biết ở đâu.

2. Tìm mã của bạn

1. Đăng nhập tại app.rentmerchant.com.
2. Mở Cài đặt, rồi thẻ Tích hợp.
3. Nhấp vào một tùy chọn để mở, rồi dùng nút Sao chép mã của nó. Mã của bạn đã chứa sẵn tên tài khoản của bạn, nên hãy dán đúng như khi sao chép.

Trong các ví dụ trên trang này, your-name thay cho tên tài khoản của bạn. Hãy luôn sao chép mã thật của bạn từ trang Tích hợp thay vì gõ lại các ví dụ này.

3. Thêm tin đăng cho thuê của bạn

Tiện ích hiển thị các căn nhà bạn đăng tin. Không có gì được đăng cho đến khi bạn bật lên, từng căn một.

1. Mở Tin đăng (trong mục Cho thuê). Mọi căn hộ bạn có đều ở đó. Bất động sản không có căn hộ sẽ hiện nút Tạo tin đăng.
2. Nhấp Sửa trên một căn nhà và điền số phòng ngủ, phòng tắm, diện tích (feet vuông), tiền thuê hàng tháng, tiền đặt cọc, ngày có thể dọn vào (để trống nếu "có sẵn ngay"), thú cưng và mô tả.
3. Tải lên tối đa 12 ảnh. Ảnh đầu tiên là ảnh bìa; dùng các mũi tên để sắp xếp lại. Dữ liệu vị trí được tự động xóa khỏi mọi ảnh.
4. Đánh dấu Đăng tin công khai căn nhà này và nhấp Lưu tin đăng.

Khi một căn nhà đã cho thuê, hãy nhấp Gỡ tin đăng trên trang Tin đăng. Căn nhà sẽ biến mất khỏi trang web của bạn trong vòng năm phút, không cần thay đổi mã.

4. Tiện ích tin đăng

Hiển thị các căn nhà bạn đăng tin dưới dạng thẻ có ảnh, tiền thuê, số phòng ngủ, phòng tắm và tình trạng còn trống. Khách truy cập nhấp vào thẻ để mở trang tin đăng.

Phương án A: mã tiện ích (khuyên dùng)

Vừa với chiều rộng trang của bạn và tự mở rộng theo số tin đăng. Dán vào vị trí bạn muốn tin đăng hiển thị:

<div data-rentmerchant-listings="your-name"></div>
<script src="https://app.rentmerchant.com/embed/v1/listings.js" async></script>

Phương án B: iframe

Dành cho các công cụ tạo trang không cho phép script. Đây là một khung có chiều cao cố định và cuộn được:

<iframe src="https://app.rentmerchant.com/embed/listings/your-name" title="Available rentals"
        loading="lazy" style="width:100%;height:900px;border:0"></iframe>

Nếu công cụ tạo trang của bạn cho phép đặt script bên cạnh, hãy dùng phiên bản tự điều chỉnh kích thước trên trang Tích hợp. Phiên bản này thêm một dòng giúp khung cao vừa đúng bằng danh sách tin đăng của bạn.

5. Nút cư dân nổi

Thêm một nút Cư dân vào góc dưới của mọi trang. Nút này mở một menu nhỏ: Đăng nhập cư dân, Trả tiền thuê nhà, Gửi yêu cầu sửa chữa, Nộp đơn ngay và Nhà đang cho thuê (mỗi mục chỉ hiện khi áp dụng cho tài khoản của bạn). Chỉ cần dán một lần, vào khu vực của công cụ tạo trang dùng để thêm mã cho mọi trang (thường gọi là mã toàn trang, mã chân trang hoặc code injection):

<script src="https://app.rentmerchant.com/embed/v1/resident-button.js" data-rentmerchant-site="your-name" async></script>

Nếu công cụ tạo trang của bạn không có khu vực mã toàn trang, hãy dán vào từng trang mà bạn muốn có nút.

6. Nút và liên kết

Nút: trong mục Nút của phần Tích hợp, đánh dấu các nút bạn muốn, chọn màu, xem bản xem trước và sao chép mã. Các nút này là liên kết có định dạng đơn giản, nên chúng hoạt động trong mọi công cụ tạo trang chấp nhận HTML, kể cả bản tin email.

Liên kết (mọi gói): sao chép bất kỳ liên kết nào vào menu điều hướng, chân trang, hồ sơ mạng xã hội hoặc chữ ký email của bạn. Trong hầu hết các công cụ tạo trang: mở trình chỉnh sửa menu, thêm một mục liên kết và dán địa chỉ.

7. Mã QR

Trong mục mã QR, nhấp Tải xuống PNG bên dưới mã bạn muốn. In nó lên biển "Cho thuê" (dùng Nhà đang cho thuê hoặc Nộp đơn ngay), thông báo ở phòng giặt (Trả tiền thuê nhà hoặc Sửa chữa), hoặc bộ tài liệu khi dọn vào. In với chiều rộng ít nhất 2,5 cm (1 inch) và quét thử bằng điện thoại của bạn trước khi in hàng loạt.

8. Hướng dẫn từng bước cho công cụ tạo trang web của bạn

Các công cụ tạo trang thỉnh thoảng thay đổi menu. Nếu nhãn bên dưới không khớp chính xác, hãy tìm thành phần có tên HTML, Embed hoặc Code.

Wix

1. Tin đăng hoặc nút: trong Editor, nhấp Add Elements (+), rồi Embed Code, rồi Embed HTML. Chọn Mã, dán và nhấp Update. Kéo khung đến kích thước bạn muốn.
2. Nút cư dân: vào Cài đặt của trang web, rồi Custom Code (trong mục Advanced), nhấp Add Custom Code, dán, chọn All pages và Body, end. Wix chỉ cung cấp Custom Code cho các trang web có tên miền đã kết nối và gói trả phí.
3. Xuất bản trang web của bạn.

Squarespace

1. Tin đăng hoặc nút: chỉnh sửa trang, nhấp vào một điểm chèn, chọn Mã, dán và đảm bảo Display Source đang tắt.
2. Nút cư dân: mở Cài đặt, rồi Developer Tools (hoặc Advanced), rồi Code Injection, và dán vào Footer.
3. Script trong khối Code và Code Injection cần gói Squarespace có hỗ trợ mã tùy chỉnh. Nếu mã tiện ích không chạy, hãy dùng tùy chọn iframe thay thế.

WordPress

1. Tin đăng hoặc nút: chỉnh sửa trang, nhấp +, thêm một khối Custom HTML, dán và cập nhật trang.
2. Nút cư dân: dùng phần cài đặt mã chân trang của giao diện nếu có, hoặc một plugin mã đầu trang và chân trang (ví dụ WPCode), rồi dán vào chân trang.
3. Trên WordPress.com (dịch vụ lưu trữ sẵn), script chỉ hoạt động trên các gói cho phép plugin và mã tùy chỉnh. Với các gói khác, hãy dùng tùy chọn iframe và các nút.

GoDaddy Websites + Marketing

1. Chỉnh sửa trang web, nhấp Add Section, tìm HTML và thêm vào.
2. Dán mã vào ô mã tùy chỉnh của phần đó và nhấp Xong. Ở đây, tùy chọn iframe là đáng tin cậy nhất.
3. Với nút cư dân, hãy tìm mã toàn trang trong Cài đặt của trang web. Nếu gói của bạn không có tính năng này, hãy thêm các nút vào trang thay thế.

Weebly (Square Online classic)

1. Tin đăng hoặc nút: kéo một thành phần Embed Code vào trang, nhấp vào nó, chọn Edit Custom HTML và dán.
2. Nút cư dân: Cài đặt, rồi SEO, rồi dán vào Footer Code.

Webflow

1. Tin đăng hoặc nút: kéo một thành phần Code Embed vào trang và dán.
2. Nút cư dân: Site settings, rồi Custom code, và dán vào Footer code. Xuất bản.
3. Webflow yêu cầu gói trang web trả phí để dùng mã tùy chỉnh.

Trang web tùy chỉnh hoặc tự xây dựng

Dán mã tiện ích vào chỗ tin đăng cần hiển thị, và nút cư dân ngay trước thẻ đóng </body>. Hoặc dùng Nguồn dữ liệu JSON để tự xây dựng thiết kế của bạn.

9. Tham chiếu tùy chọn

Ví dụ, một tiện ích hiển thị ba căn nhà với màu xanh mòng két:

<div data-rentmerchant-listings="your-name" data-limit="3" data-accent="#0f766e"></div>
<script src="https://app.rentmerchant.com/embed/v1/listings.js" async></script>

10. Dành cho nhà phát triển web: nguồn dữ liệu JSON

Hai nguồn dữ liệu công khai, chỉ đọc, mang cùng dữ liệu như các tiện ích. Không cần khóa, cho phép yêu cầu cross-origin, và phản hồi được lưu đệm trong năm phút.

GET https://app.rentmerchant.com/r/your-name/listings.json
GET https://app.rentmerchant.com/r/your-name/links.json

Mỗi mục trong listings bao gồm:

{
  "id": 476,
  "title": "Capitol Flats · Unit 102",
  "city": "Columbus, OH",
  "rent": "$1,950/mo",          "rent_amount": 1950,
  "deposit": "$1,950",
  "facts": ["2 bed", "1 bath", "880 sq ft"],
  "bedrooms": 2, "bathrooms": 1, "square_feet": 880,
  "available": "Available now", "available_on": null,
  "pets": "Cats OK",
  "description": "Bright corner two bedroom...",
  "photos": [{ "url": "...", "thumb": "...", "w": 2000, "h": 1500 }],
  "url": "https://app.rentmerchant.com/r/your-name/listings/476",
  "apply_url": "https://app.rentmerchant.com/apply/...?unit=476"
}

Hiển thị văn bản đúng như được cung cấp và liên kết đến url và apply_url thay vì tự xây dựng biểu mẫu đăng ký. Địa chỉ đầy đủ chỉ có trên trang tin đăng, không có trong nguồn dữ liệu. links.json trả về tên, màu nhấn và các liên kết cư dân của bạn (key, label, url).

11. Khắc phục sự cố

Khu vực tiện ích bị trống.

Công cụ tạo trang có thể đang loại bỏ script; hãy dùng tùy chọn iframe. Đồng thời kiểm tra rằng tài khoản của bạn đang dùng gói Pro, email đã được xác nhận, và mã đã được dán đầy đủ.

Tiện ích báo không có căn nhà nào đang cho thuê.

Mở Tin đăng trong tài khoản và đảm bảo ít nhất một căn nhà được đánh dấu là đã đăng tin. Thay đổi sẽ xuất hiện trong vòng năm phút.

Trông ổn trong trình chỉnh sửa nhưng không hiện trên trang web thật của tôi.

Hầu hết các công cụ tạo trang chỉ chạy script trên trang web đã xuất bản, không chạy trong bản xem trước của trình chỉnh sửa. Hãy xuất bản, rồi kiểm tra địa chỉ trang thật.

Iframe bị cắt hoặc có thanh cuộn.

Dùng phiên bản tự điều chỉnh kích thước, hoặc tăng giá trị height trong mã iframe.

Nút cư dân không xuất hiện.

Mã phải nằm trong khu vực mã toàn trang hoặc trên chính trang đó, và chỉ xuất hiện trên trang web đã xuất bản. Nếu tài khoản của bạn không có liên kết nào để hiển thị, nút sẽ ẩn.

Việc khác?

Mở Hỗ trợ trong tài khoản và cho chúng tôi biết địa chỉ trang web và công cụ tạo trang bạn dùng. Chúng tôi sẽ xem giúp.

12. Bảo mật và quyền riêng tư

• Thanh toán và đăng nhập luôn mở trên RentMerchant. Người thuê nhà không bao giờ nhập mật khẩu hay thông tin ngân hàng vào trang web của bạn.
• Các tiện ích chỉ hiển thị liên kết và ảnh của RentMerchant, và được cách ly khỏi phần mã và kiểu dáng còn lại của trang.
• Chỉ những căn nhà bạn đăng tin mới được công khai. Gỡ tin một căn nhà sẽ xóa nó khỏi mọi nơi cùng lúc.
• Dữ liệu vị trí và các thông tin ẩn khác được xóa khỏi mọi ảnh bạn tải lên.
• Nếu một tài khoản bị đóng, bị tạm ngưng hoặc rời gói Pro, tin đăng và tiện ích của tài khoản đó sẽ tự động ngừng hiển thị.