Setup guide

Website integrations

Paano ilagay ang iyong mga RentMerchant listing, Pay Rent button, resident menu at mga QR code sa website na mayroon ka na. Natatapos ito ng karamihan sa mga landlord sa loob ng mga sampung minuto.

1. Bago ka magsimula

2. Hanapin ang iyong code

  1. Mag-sign in sa app.rentmerchant.com.
  2. Buksan ang Settings, pagkatapos ay ang Mga integration tab.
  3. Mag-click ng opsyon para buksan ito, pagkatapos ay gamitin ang Kopyahin ang code button nito. Nasa iyong code na ang sarili mong account name, kaya i-paste ito nang eksakto kung paano kinopya.

Sa mga halimbawa sa page na ito, ang your-name ay pumapalit sa pangalan ng iyong account. Laging kopyahin ang iyong totoong code mula sa Integrations page sa halip na i-type ulit ang mga ito.

3. Idagdag ang iyong mga rental listing

Ipinapakita ng widget ang mga bahay na inilista mo. Walang nakalista hangga't hindi mo ito ino-on, isang bahay sa bawat pagkakataon.

  1. Buksan ang Mga listing (sa ilalim ng Leasing). Nandoon ang bawat unit mo. Ang property na walang unit ay nagpapakita ng Gumawa ng listing button.
  2. I-click ang I-edit sa isang bahay at punan ang bilang ng kuwarto, banyo, square feet, buwanang upa, deposit, ang petsa kung kailan ito available (iwanang blangko para sa "available ngayon"), pets, at deskripsyon.
  3. Mag-upload ng hanggang 12 litrato. Ang unang litrato ang cover; gamitin ang mga arrow para baguhin ang pagkakasunod-sunod. Awtomatikong tinatanggal ang location data sa bawat litrato.
  4. I-tick ang Ilista nang publiko ang bahay na ito at i-click ang I-save ang listing.

Kapag naupahan na ang isang bahay, i-click ang Alisin sa listahan sa Listings page. Mawawala ito sa iyong website sa loob ng limang minuto, walang code na kailangang baguhin.

May sariling page din ang bawat listing na may photo gallery at Mag-apply para sa bahay na ito button. Nagbubukas ang application form nang napili na ang bahay na iyon, at napupunta ang mga application sa iyong Mga aplikasyon tab.

4. Listings widget

Ipinapakita ang iyong mga nakalistang bahay bilang mga card na may litrato, upa, bilang ng kuwarto, banyo at availability. Kini-click ng mga bisita ang card para buksan ang listing page nito.

Option A: widget code (inirerekomenda)

Kasya sa lapad ng iyong page at lumalaki para magkasya ang iyong mga listing. I-paste ito kung saan dapat lumabas ang mga listing:

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

Option B: iframe

Para sa mga builder na hindi pinapayagan ang script. Isa itong box na may nakapirming taas na nag-i-scroll:

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

Kung pinapayagan ng iyong builder ang script sa tabi nito, gamitin na lang ang auto-sizing version mula sa Integrations page. Nagdadagdag ito ng isang linya na ginagawang eksaktong kasintaas ng iyong mga listing ang box.

5. Floating resident button

Nagdadagdag ng Mga resident button sa ibabang sulok ng bawat page. Nagbubukas ito ng maliit na menu: Resident Login, Pay Rent, Submit a Maintenance Request, Apply Now at Available Rentals (bawat isa ay ipinapakita lang kapag naaangkop sa iyong account). I-paste ito nang isang beses, sa bahagi ng iyong builder na nagdadagdag ng code sa bawat page (karaniwang tinatawag na site-wide code, footer code o code injection):

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

Kung walang site-wide code area ang iyong builder, i-paste ito sa bawat page kung saan mo gusto ang button.

6. Mga button at link

Mga button: sa Buttons section ng Integrations, i-tick ang mga button na gusto mo, pumili ng kulay, tingnan ang preview, at kopyahin ang code. Mga simpleng styled link lang ang mga button, kaya gumagana ang mga ito sa anumang builder na tumatanggap ng HTML, kasama ang mga email newsletter.

Mga link (bawat plan): kopyahin ang anumang link sa navigation menu ng iyong site, sa footer, sa isang social media profile, o sa iyong email signature. Sa karamihan ng builder: buksan ang menu editor, magdagdag ng link item, at i-paste ang address.

7. Mga QR code

Sa QR codes section, i-click ang I-download ang PNG sa ilalim ng code na gusto mo. I-print ito sa "For Rent" sign (gamitin ang Available Rentals o Apply Now), sa abiso sa laundry room (Pay Rent o Maintenance), o sa iyong move-in packet. I-print ito nang hindi bababa sa 2.5 cm (1 pulgada) ang lapad at i-scan ito gamit ang sarili mong phone bago mag-print ng marami.

8. Hakbang-hakbang para sa iyong website builder

Paminsan-minsang binabago ng mga builder ang kanilang mga menu. Kung hindi eksaktong tugma ang isang label sa ibaba, hanapin ang element na tinatawag na HTML, Embed o Code.

Wix

  1. Listings o mga button: sa Editor, i-click ang Add Elements (+), pagkatapos ay Embed Code, pagkatapos ay Embed HTML. Piliin ang Code, i-paste, at i-click ang Update. I-drag ang box sa laki na gusto mo.
  2. Resident button: pumunta sa Settings ng iyong site, pagkatapos ay Custom Code (sa ilalim ng Advanced), i-click ang Add Custom Code, i-paste, piliin ang All pages at Body, end. Inaalok lang ng Wix ang Custom Code sa mga site na may naka-connect na domain at bayad na plan.
  3. I-publish ang iyong site.

Squarespace

  1. Listings o mga button: i-edit ang page, mag-click ng insert point, piliin ang Code, i-paste, at siguraduhing naka-off ang Display Source.
  2. Resident button: buksan ang Settings, pagkatapos ay Developer Tools (o Advanced), pagkatapos ay Code Injection, at i-paste sa Footer.
  3. Ang mga script sa Code block at Code Injection ay nangangailangan ng Squarespace plan na may kasamang custom code. Kung hindi tumatakbo ang widget code, gamitin na lang ang iframe option.

WordPress

  1. Listings o mga button: i-edit ang page, i-click ang +, magdagdag ng Custom HTML block, i-paste, at i-update ang page.
  2. Resident button: gamitin ang footer code setting ng iyong theme kung mayroon ito, o isang header and footer code plugin (halimbawa WPCode), at i-paste sa footer.
  3. Sa WordPress.com (ang hosted service), gumagana lang ang mga script sa mga plan na pinapayagan ang plugin at custom code. Sa ibang plan, gamitin ang iframe option at ang mga button.

GoDaddy Websites + Marketing

  1. I-edit ang iyong site, i-click ang Add Section, hanapin ang HTML, at idagdag ito.
  2. I-paste ang iyong code sa custom code box ng section at i-click ang Tapos na. Ang iframe option ang pinaka-maaasahan dito.
  3. Para sa resident button, tumingin sa Settings ng iyong site para sa site-wide code. Kung wala nito ang iyong plan, idagdag na lang ang mga button sa iyong mga page.

Weebly (Square Online classic)

  1. Listings o mga button: i-drag ang isang Embed Code element sa page, i-click ito, piliin ang Edit Custom HTML, at i-paste.
  2. Resident button: Settings, pagkatapos ay SEO, pagkatapos ay i-paste sa Footer Code.

Webflow

  1. Listings o mga button: i-drag ang isang Code Embed element sa page at i-paste.
  2. Resident button: Site settings, pagkatapos ay Custom code, at i-paste sa Footer code. I-publish.
  3. Kailangan ng Webflow ng bayad na site plan para sa custom code.

Custom o hand-built na site

I-paste ang widget code kung saan dapat ang mga listing, at ang resident button bago mismo ang pansarang </body> tag. O gamitin ang Mga JSON feed para gumawa ng sarili mong disenyo.

9. Sanggunian ng mga option

AttributeGumagana saAno ang ginagawa nito
data-limit="3"Listings widgetIpakita lang ang unang ilang bahay (pinakamaagang available muna).
data-accent="#0f766e"Listings widget, resident buttonAng sarili mong kulay, bilang anim na digit na hex code. Ang default ay RentMerchant indigo.
data-position="left"Resident buttonIlagay ang button sa ibabang kaliwang sulok sa halip na sa kanan.
data-label="Tenants"Resident buttonPalitan ang text ng button (hanggang 24 na character).
?accent=0f766eIframe addressAng iyong kulay para sa iframe version, idinadagdag sa dulo ng address nito.

Halimbawa, widget na nagpapakita ng tatlong bahay sa kulay teal:

<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. Para sa mga web developer: JSON feed

Dalawang pampubliko at read-only na feed ang may parehong data gaya ng mga widget. Hindi kailangan ng key, pinapayagan ang cross-origin request, at naka-cache ang mga response nang limang minuto.

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

Kasama sa bawat item sa listings ang:

{
  "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"
}

Ipakita ang text nang eksakto kung paano ito ibinigay at mag-link sa url at apply_url sa halip na gumawa ng sarili mong application form. Nasa listing page lang ang buong street address, wala sa feed. Ibinabalik ng links.json ang iyong pangalan, accent color, at ang mga resident link (key, label, url).

11. Pag-troubleshoot

Walang laman ang widget area.
Maaaring tinatanggal ng iyong builder ang mga script; gamitin ang iframe option. Tingnan din kung nasa Pro ang iyong account at kumpirmado ang iyong email, at kung buong na-paste ang code.
Sinasabi nitong walang available na bahay.
Buksan ang Listings sa iyong account at siguraduhing may kahit isang bahay na naka-tick bilang listed. Lumalabas ang mga pagbabago sa loob ng limang minuto.
Maayos ang itsura sa editor pero hindi sa aking live site.
Sa karamihan ng builder, tumatakbo lang ang mga script sa na-publish na site, hindi sa editor preview. I-publish, pagkatapos ay tingnan ang live na address.
Naputol ang iframe o may scroll bar ito.
Gamitin ang auto-sizing version, o taasan ang value ng height sa iframe code.
Hindi lumalabas ang resident button.
Kailangang nasa site-wide code area ito o nasa mismong page, at lumalabas lang ito sa na-publish na site. Kung walang link na maipapakita ang iyong account, nananatili itong nakatago.
Iba pa?
Buksan ang Support sa iyong account at sabihin sa amin ang address ng iyong website at ang iyong builder. Titingnan namin ito.

12. Seguridad at privacy

Handa ka na bang i-connect ang iyong site?

Mag-sign in at buksan ang Integrations, o tingnan muna kung paano gumagana ang listings widget.