ဒီပလပ်အင်သည် admin အခွင့်အရေးနှင့်အသုံးပြုသူအကောင့်တစ်ခု ၀ င်သောအခါမျက်နှာစာစာမျက်နှာများရှိ 'ဒီစာမျက်နှာကိုတည်းဖြတ်ရန်' ခလုတ်ကိုထည့်သည်။ ထိုခလုတ်ကိုနှိပ်ပြီးနောက်သင်၏စာမျက်နှာ၌တည်းဖြတ်နိုင်သောသင်၏ Dashboard ၌အခြား Admin tab ကိုဖွင့်လိမ့်မည်။

အရေးကြီး (၁) ။ အကယ်၍ အသုံးပြုသူသည်စီမံခန့်ခွဲသူ (superuser) အဖြစ် log in မ ၀ င်ပါက၎င်းကို plugin setting တွင်အတိအကျသတ်မှတ်သည့်အခါမှသာခလုတ်ပေါ်လာလိမ့်မည်။ ပုံမှန်အားဖြင့်ခလုတ်ကိုကြည့်ရန်အသုံးပြုသူတစ် ဦး သည် log in ဝင်ရန်လိုသည်။

အရေးကြီးသောအချက် (၂): သင်ဤ plugin မှကိုယ်တိုင် ဝင်၍ မရပါ။ Administrator Dashboard ထဲသို့ ၀ င်ရန် login ကို သုံး၍ login ၀ င်ရမည်။ Login မ ၀ င်လျှင် GRAV CMS မှ login dialog ကိုပြလိမ့်မည်။

မင်းရဲ့ browser ရဲ့အခြား tab မှာ admin dashboard ဖွင့်လိုက်တာနဲ့လည်းအလုပ်လုပ်လိမ့်မယ်။ သင်ဝင်ရောက်ပြီးစာမျက်နှာများကိုတည်းဖြတ်နိုင်သည့်အခါခလုတ်သည်မျက်နှာစာစာမျက်နှာများပေါ်တွင်ပေါ်လာလိမ့်မည်။ သင်ထွက်သွားသည့်အချိန်၌သင်ပြသသောစာမျက်နှာများကိုတည်းဖြတ်နိုင်မည်မဟုတ်ပါ။ အလိုအလျောက်ပြန်လည်စတင်ခြင်းသည်ဤအရာကိုကာကွယ်လိမ့်မည်။

လိုအပ်ချက်များ
ဤပလပ်အင်သည်သင့်အားအောက်ပါ plugins များတပ်ဆင်ပြီးဖွင့်ထားရန်လိုအပ်သည်။

admin ပါ
လော့ဂ်အင်
တပ်ဆင်ခြင်း
Frontend Edit Button plugin ကို install လုပ်ခြင်းသည်နည်းလမ်းအမျိုးမျိုးဖြင့်လုပ်ဆောင်နိုင်သည်။ GPM (Grav Package Manager) တပ်ဆင်ခြင်းနည်းလမ်းသည် plugin ကိုရိုးရှင်းသော terminal command တစ်ခုဖြင့်လျင်မြန်လွယ်ကူစွာ install လုပ်နိုင်သည်၊ Manual နည်းလမ်းသည် zip file မှတဆင့်သင်လုပ်နိုင်စေသည်။

GPM တပ်ဆင်ခြင်း (ဦး စားပေး) **
ဒီ plugin ကို install လုပ်ရန်အရိုးရှင်းဆုံးနည်းလမ်းသည် Grav Package Manager (GPM) မှတဆင့်သင်၏ system terminal (command line) ဟုခေါ်သည်။ သင်၏ Grav install ၏အမြစ်မှ

bin/gpm တွင် frontend-edit-button ကို install လုပ်ပါ
ဤအရာသည် Frontpage Edit Button plugin ကို Grav အတွင်းသင်၏ /user /plugins directory ထဲသို့ထည့်သွင်းလိမ့်မည်။ ၎င်း၏ဖိုင်များကို/your/site/grav/user/plugins/grav-frontend-edit-button အောက်တွင်တွေ့နိုင်သည်။

Git clone
သင့် site ၏ user/plugins ဖိုင်တွဲတွင်

git clone https://github.com/enovision/grav-frontend-edit-button
ကိုယ်တိုင်တပ်ဆင်ခြင်း
ဒီပလပ်အင်ကို install လုပ်ရန်ဤ repository ၏ zip version ကို download လုပ်ပြီး၎င်းကိုသင်၏/site/grav/user/plugins အောက်တွင်ဖြည်ပါ။ ထို့နောက်ဖိုင်တွဲကို grav-frontend-edit-button သို့အမည်ပြောင်းပါ။ ဤဖိုင်များကို GitHub သို့မဟုတ် GetGrav.org မှတဆင့်သင်ရှာနိုင်သည်။

ယခုသင့်တွင် plugin ဖိုင်အားလုံးရှိသင့်သည်

/your/site/grav/user/plugins/grav-frontend-edit-button ကိုနှိပ်ပါ
မှတ်ချက်။ ဤပလပ်အင်သည် Grav အတွက်လုပ်ဆောင်ရန်လိုအပ်သောအမှားနှင့်ပြသနာများအတွက် modular component တစ်ခုဖြစ်သည်။

ပြုပြင်ခြင်း
ဒီ plugin ကိုမသတ်မှတ်ခင် user/plugins/grav-frontend-edit-button/grav-frontend-edit-button.yaml ကို user/config/plugins/grav-frontend-edit-button.yaml သို့သာ copy ကူးသင့်သည်။ မိတ္တူ။

ဤတွင်ပုံသေပြင်ဆင်မှုနှင့်ရနိုင်သောရွေးချယ်စရာများကိုရှင်းပြချက်သည်

enabled: မှန်ပါတယ်
ခလုတ်၏တည်နေရာအောက်ပါရွေးချယ်မှုများရရှိနိုင်ပါသည်။

(tr) အပေါ်ညာဘက် (ပုံသေ)
(tl) ဘယ်ဘက်ထိပ်
(br) ညာဘက်အောက်ခြေ
(bl) ဘယ်ဘက်အောက်ခြေ
ရာထူး: tr
ခလုတ်ပေါ်တွင်တံဆိပ်ကိုပြပါ

showLabel: မှန်ပါတယ်
ပြရန်သင်္ကေတ (Fontawesome ကိုတင်ရန်လိုအပ်သည်၊ ၎င်းသည် plugin Markdown Font Awesome ကို install သောအခါ၎င်းသည်အလုပ်လုပ်သည်)

showIcon: မှန်ပါတယ်
အရေးကြီး: showLabel နှင့် showIcon နှစ်ခုလုံးကိုပိတ်ထားလျှင်၎င်းသည်ပြည်တွင်း showLabel = true အလိုအလျောက်သုံးလိမ့်မည်။

login လုပ်ပြီးမှသာမြင်နိုင်သည်

requireAuth: မှန်ပါတယ်
အသုံးပြုမှု
ပလပ်အင်ကိုဖွင့်ထားလျှင်လုပ်စရာအခြားမရှိပါ၊ ၎င်းသည်မျက်နှာစာစာမျက်နှာများပေါ်တွင်ခလုတ်ကိုပြလိမ့်မည်။

စာမျက်နှာတစ်မျက်နှာ၏ရှေ့မျက်နှာစာအားအောက်ပါခေါင်းစဉ် (headmatter) သို့ထည့်ခြင်းအားဖြင့်တစ်မျက်နှာချင်းစီကိုပိတ်ပစ်ရန်ဖြစ်နိုင်သည်။

protectEdit: မှန်ပါတယ်
လန်းဆန်းစေသည်
ဤပလပ်အင်တွင်ပါဝင်သော browser tab ၏မှုန်ဝါးမှုနှင့်အာရုံကိုတုံ့ပြန်မည့်ရိုးရှင်းသောယန္တရားတစ်ခုပါ ၀ င်သည်။ သင်ခလုတ်ကိုနှိပ်လိုက်လျှင် browser ရှိအခြား tab တစ်ခုတွင် Dashboard ကိုဖွင့်လိမ့်မည်။ ခလုတ်ကိုနှိပ်လိုက်ရုံနဲ့သင်ထွက်သွားတဲ့စာမျက်နှာကိုသင်ပြန်နှိပ်လိုက်တဲ့အခါဒီစာမျက်နှာကအလိုအလျောက်ပြန်လည်လန်းဆန်းသွားပါလိမ့်မယ်။

သင်ဤ tab ကို (မှုန်ဝါးဝါး) မှချန်ထားပြီးတင်ပြထားသောစာမျက်နှာရှိ tab ကိုပြန်အာရုံစိုက်သောအခါဤပြန်လည်ဆန်းသစ်မှုသည်အမြဲလုပ်ဆောင်လိမ့်မည်။

CSS နှင့် JavaScript
လိုအပ်သော CSS နှင့် JavaScript ကို plugin သည်လုပ်ဆောင်ရန်လိုအပ်ချက်များနှင့်ပြည့်စုံမှသာတင်လိမ့်မည်။

CSS
scss folder တွင် style.scss file ကို modify လုပ်ခြင်းဖြင့်ခလုတ်၏ပုံစံကိုသင်ပြောင်းနိုင်သည်။ အောက်ပါ CSS tag များသည်နဂိုအတိုင်းရှိနေရန်လိုအပ်သည်။

frontend-edit-button {

position: fixed;
z-index: 10000;
padding: 5px;
}

frontend-edit-button.top {

top: 0;
}

frontend-edit-button.bottom {

bottom: 0;
}

frontend-edit-button.left {

left: 0;
}

frontend-edit-button.right {

right: 0;
}
ဤ plugin ./sass.cmd ၏ root of /assets folder ထဲသို့ ၀ င်ခြင်းအားဖြင့် SASS ကိုသင်စုစည်းနိုင်သည်။ သင် compiler ကို install လုပ်ရန်လိုအပ်သည်။

i18n
ဘာသာစကားမျိုးစုံထောက်ခံမှုရနိုင်သောဘာသာစကားဖိုင်တစ်ခုရှိပါသည်

ခရက်ဒစ်
အံ့သြဖွယ်ကောင်းသော CMS များတည်ဆောက်ရန်အံ့သြဖွယ် GRAV CMS အဖွဲ့။
လမ်းကြောင်းအမှားအချို့ကိုပြုပြင်ရန် Nick Bell
Christian Bewernitz သည် login လိုအပ်ချက် option (version 1.0.7) ကိုထည့်ရန်