دو راه برای استفاده از بهنویس در سایت شما وجود دارد. یکی‌ استفاده از API بهنویس، که امکان تبدیل را مستقیما در مکان ورود متن به صفحهٔ شما فراهم می‌کند، دیگری استفاده به صورت ابزار مستقل (gadget) که درون یک iframe به صورت مجزا قرار می‌گیرد (شبیه ابزارهای صفحهٔ igoogle). استفاده به صورت API تجربه بهتری برای بینندگان شما فراهم خواهد کرد در حالی‌ که استفاده به صورت ابزار مستقل ساده‌تر می‌باشد.

دربارهٔ Behnevis API

پس از گذشت یک سال از شروع فعالیت بهنویس و بهبود قابلیتهای سیستم، تصمیم گرفتیم که توانایی‌های بهنویس را به صورت رایگان در اختیار دیگر سایت‌ها بگذاریم. Behnveis API به راحتی‌ در سایت شما قرار می‌گیرد و بازدید‌کنندگان شما پینگلیش را در سایت شما به فارسی‌ تبدیل کرده و از آن برای جستجو در سایت، نوشتن کامنت ... استفاده می‌کنند. برای دیدن مثالی از کاربرد Behnevis API لطفا به این آدرس بروید:

http://www.behnevis.com/api/example.html

برای فراهم آوردن بهترین امنیت، فایل‌های های API که در صفحهٔ شما قرار میگیرند همه در Amazon S3 Storage Cloud قرار دارند. این همان سیستمی‌ هست که فایل‌های خود Amazon.com و هزارن سازمان دیگر رو میزبانی می‌کند. در ضمن کد‌های Bullterin-Board بطور خودکار تشخیص داده شده و دست نخورده باقی‌ میمانند.

افزودن توانایی‌‌های بهنویس به سایت شما ساده است:

۱. ابتدا یک خط جاواسکریپت را در قسمت Header صفحهٔ HTML خود اضافه کنید:

<script type="text/javascript" src=" http://behnevis.s3.amazonaws.com/behnevisapi.js"></script>

۲. سپس به بخش‌هایی‌ از صفحه که متن ورودی در آنجا وارد میشود (input elements) یک ID اضافه کنید (اگر ID ندارند)، بطور مثال:

<input name="target_element" type="text" id="Target_element_id"/>

۳. یک تصویر کوچک Behnevis API enable در کنار بخش ورود متن اضافه کنید تا بینندگان از امکان تبدیل پینگیلیش به فارسی‌ با در سایت شما مطلع شوند:

<a href="#"><img src="http://behnevis.s3.amazonaws.com/behnevis_enable_green.gif" alt="" style="border:none" onclick="return behnevis.launchPopup(this, 'Target_element_id');"/></a>

لطفا توجه فرمایید که تابع ()behnevis.launchPopup در هنگام وقوع رویداد onClick با پارامتر Target_element_id فرا‌خوانده میشود. همچنین ما توصیه می‌کنیم که این تصویر کوچک را در کنار تمام بخش‌های سایت شما که از API استفاده میکنند بگذارید تا بیندگان فورا متوجه امکان تبدیل پینگیلیش به فارسی‌ شوند.

۴. علاوه بر افزودن تصویر، شما میتوانید یک متن کوتاه هم در کنار آن بیفزایید

<a href="#" onclick="return behnevis.launchPopup(this, 'Target_element_id');" >تبدیل پینگلیش به فارسی</a>

حجم API بهنویس تنها ۱۹ کیلوبایت است. خوشحال خواهیم شد اگر پس از افزودن API به سایت خود به ما یک ایمیل بزنید تا ما سایت شما را به لیست سایت‌هایی‌ که از API استفاده میکنند اضافه کنیم. لطفا اگر سوال یا پیشنهادی داشتید با ما به آدرس behnevis contact email تماس بگیرید.

استفاده به صورت ابزار مستقل (gadget)

اگر به جای استفاده از API مایل به افزودن ابزار ویرایشگر بهنویس به سایت خود هستید، دو انتخاب دارید: یکی‌ استفاده از gadget بهنویس در igoogle که دارای دو قسمت (یکی‌ برای ورود متن پینگیلیش و دیگری نمایش تبدیل فارسی‌) است و قادر هستید به سادگی‌ شکل حاشیهٔ و دیگر مشخصات را از این لینک انتخاب کرده و کد را تحویل بگیرید.
انتخاب دیگر شما استفاده از ابزار یک قسمتی‌ بهنویس است که تبدیل پینگیلیش به فارسی‌ در آن پس از فشردن کلید فاصله space انجام میشود. برای این کار لطفا از کد زیر استفاده کنید:

<iframe src="http://behnevis.com/api/write_short_text_single.html" width="500px" height="180px" align="center" frameborder="1" marginwidth="0px" marginheight="0px" scrolling="auto"</iframe>

که ابزار زیر را به سایت شما می‌افزاید: