فرمهای ثبتنام
همهٔ فرمانهای فرمهای ثبتنام و کسانی که آنها را پر میکنند، با نمونههای کاربردی.
چطور کنار هم قرار میگیرند
فرم ثبتنام کسانی را که آن را پر میکنند به گروههای مخاطبان شما میافزاید. یک پیشنویس و یک نسخهٔ فعال نگه میدارد: update پیشنویس و تنظیمات را تغییر میدهد، و publish پیشنویس را فعال میکند. خواندن به forms:read و تغییر دادن به forms:write نیاز دارد. resend-confirmation، و هر تغییری که باعث شود فرم ایمیل بفرستد، به emails:send هم نیاز دارد.
openemail forms create --name "Newsletter sign-up" --starter newsletter --publishopenemail forms list-submissions frm_3b9d2e7a1c4f80d56e2a9b14 --status pendingopenemail forms analytics frm_3b9d2e7a1c4f80d56e2a9b14 --days 30فرمها
| فرمان | چه میکند |
|---|---|
| openemail forms list | یک صفحه از فرمها، تازهترین در ابتدا، با وضعیت و آمارشان |
| openemail forms create --name <value> | ساختن یک پیشنویس از --starter، یک فایل --document یا یک فیلد ایمیل. --publish آن را بیدرنگ فعال میکند |
| openemail forms get <id> | یک فرم با پیشنویس، نسخهٔ فعال و تنظیماتش |
| openemail forms update <id> | تغییر نام، پیشنویس --document یا هر تنظیمی، مانند --settings-double-opt-in، در یک فراخوانی |
| openemail forms publish <id> | فعال کردن پیشنویس |
| openemail forms pause <id> | متوقف کردن پذیرش ثبتنام در یک فرم منتشرشده |
| openemail forms resume <id> | باز کردن دوبارهٔ یک فرم متوقف |
| openemail forms duplicate <id> | کپی یک فرم در پیشنویسی تازه، بدون ثبتنامهایش |
| openemail forms delete <id> | حذف یک فرم و ثبتنامهایش پس از تأیید شما. ورود با مرورگر کد تأیید هویت هم میخواهد |
| openemail forms list-starters | نقطههای شروعی که یک فرم تازه میتواند از آنها آغاز شود |
| openemail forms get-starter <slug> | یک نقطهٔ شروع با سندش |
| openemail forms analytics <id> | بازدیدها، ثبتنامها و افراد افزودهشده در یک بازه، که 30 روز است مگر اینکه --days یا --minutes چیز دیگری بگوید |
پاسخها
| فرمان | چه میکند |
|---|---|
| openemail forms list-submissions <id> | یک صفحه از ثبتنامها، تازهترین در ابتدا. --q در نشانیهای ایمیل جستوجو میکند و --status یکی از pending یا added را برمیگزیند |
| openemail forms get-submission <id> <submission-id> | یک ثبتنام با همهٔ جوابهایش |
| openemail forms delete-submission <id> <submission-id> | حذف یک ثبتنام پس از تأیید شما. شخص در مخاطبان شما میماند |
| openemail forms delete-submissions <id> <submission-ids...> | حذف تا 200 ثبتنام پس از تأیید شما |
| openemail forms approve-submission <id> <submission-id> | افزودن یک ثبتنامِ در انتظار بدون تأیید خودِ شخص. به contacts:write هم نیاز دارد |
| openemail forms resend-confirmation <id> <submission-id> | ایمیل کردن پیوند تأیید تازه برای یک ثبتنامِ در انتظار، مگر آنکه در ده دقیقهٔ گذشته یکی فرستاده شده باشد. به emails:send هم نیاز دارد |
ثبتنام کردن یک نفر
subscribe به یک فرم منتشرشده همانطور ارسال میکند که صفحهٔ آن فرم ارسال میکند. نه کلید میخواهد و نه ورود، پس بدون ورود هم کار میکند. جوابهای دیگر را با --data بهصورت JSON بدهید، و صفحهای را که فرم روی آن بود با --oe-source.
openemail forms subscribe frm_3b9d2e7a1c4f80d56e2a9b14 --email [email protected] --data '{"first_name":"Ann","consent":true}'جوابی که جا افتاده یا نادرست است با کد 7 خارج میشود و هر فیلد و دلیلش را فهرست میکند. فرم متوقف با 6 خارج میشود، و ثبتنامهای بیش از حد از یک شبکه با 8.