simple comment
1.0.0
Simple Comment adalah platform berkomentar untuk situs web apa pun. Gratis, fleksibel, sumber terbuka, pribadi, dan terukur.
Lihat demonya: https://simple-comment.netlify.app
NB: Alat moderasi belum memadai. Tidak ada pemberitahuan ketika pengguna telah memposting komentar, atau cara apa pun untuk menahannya dalam moderasi sebelum disetujui. Jika Anda menyukai proyek ini dan ingin melihatnya dikembangkan lebih lanjut dalam jangka waktu tertentu, hubungi saya. Jika tidak, proyek ini masih berjalan, tetapi dalam perjalanan yang lambat.
Fungsionalitas minimum sudah aktif dan berjalan!
Access-Control-Allow-Origin merespons variabel .envReferer dan topicId harus dipetakan dengan benarOrigin harus ada dalam daftar Access-Control-Allow-OriginSimple Comment dapat dijalankan di server yang sama dengan situs web Anda atau di server lintas domain terpisah
Komentar Sederhana perlu disajikan melalui https:
Ikuti petunjuk ini. Jika ada yang kurang jelas, silakan buat terbitan baru
example.env ke direktori root proyek yang sama dan ganti namanya menjadi .env.env , masukkan nilai rahasia Anda sendiri (dibuat atau dibuat secara acak), untuk entri ini (yaitu ganti semuanya di sebelah kanan = di setiap baris)..env tambahkan DB_CONNECION_STRING yang tepatEnvironmental Variables klik tombol Edit Variables.env tambahkan kunci dan nilai yang sesuai untuk semua variabelIS_CROSS_SITE tambahkan nilai true jika sistem komentar dihosting di domainnya sendiri dan false jika domainnya sama.<script src="[path-to]/simple-comment.js" defer></script> ( src harus mengarah ke file simple-comment.js )<div id="simple-comment-display"></div>simple-comment.js ke folder skrip situs web AndaRefused to connect to 'api/auth' because it violates the following Content Security Policy directive: connect-src 'self'https://<your-comment-app>.netlify.app ke header Kebijakan Keamanan Konten Anda di sebelah connect-src (qv https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers /Kebijakan-Keamanan-Konten/koneksi-src)Access to fetch at 'https://<your-comment-app>.netlify.app/.netlify/functions/' from origin '<your-website>' has been blocked by CORS policy...<your-website> ke kunci ALLOW_ORIGIN di .env dan sebagai variabel lingkungan Netlify login.html yang Anda upload di Setup danSIMPLE_COMMENT_MODERATOR_ID dan SIMPLE_COMMENT_MODERATOR_PASSWORD di file .env Anda Tumpukan default menggunakan Netlify + MongoDB untuk backend, dan klien berbasis fetch minimal untuk frontend, namun dapat dengan mudah diadaptasi untuk menggunakan tumpukan teknologi apa pun, selama pengujian berhasil dan API sesuai dengan file skema Open API 3
Anda bisa mendapatkan MongoDB-in-the-cloud tingkat gratis Anda sendiri dengan mengikuti petunjuk berikut
Mengasumsikan lingkungan seperti unix, seperti Ubuntu.
nvm installnpm install -g yarnyarn installyarn run buildyarn run testyarn run test:e2esudo systemctl start mongod (qv Linux)yarn run startSpesifikasi API dijelaskan oleh file simple-comment-openapi3.json dalam format Open API 3 dan dirancang agar dapat dipertukarkan dengan sistem backend, frontend, dan identifikasi apa pun
Ini adalah ikhtisar titik akhir Simple Comment API
/comment comment adalah teks yang diposkan pengguna sebagai balasan terhadap comment atau topic lain, dan menampilkan balasan ini adalah satu-satunya alasan keberadaan proyek ini!
Titik akhir komentar adalah untuk membuat, membaca, memperbarui, dan menghapus (CRUD) komentar individual. Semua komentar harus mempunyai induk, yaitu sesuatu yang dibalasnya, baik itu topic atau comment
/topicTopik adalah jenis komentar khusus yang secara default hanya dapat dibuat oleh pengguna admin, dan membentuk wadah organisasi untuk komentar yang membalas. Ini adalah semacam komentar root, dan karenanya tidak memiliki induk
Titik akhir /topic menangani CRUD untuk komentar root ini. Operasi GET pada /topic akan mendapatkan daftar topik dan GET pada /topic/{topicId} akan mendapatkan semua komentar sebagai balasan untuk topik tersebut dan turunannya
/userSecara default, komentar dapat diposting oleh pengguna anonim, namun Simple Comment memiliki skema identifikasi minimal sehingga pemberi komentar yang memilih untuk melakukannya dapat memiliki kontrol atas komentar mereka setelah diposting, sesuai dengan kebijakan
/authAuth adalah titik akhir untuk skema otentikasi dan identifikasi. Seorang pengguna mengirimkan nama pengguna dan kata sandinya ke titik akhir autentikasi, dan menerima JSON Web Token (JWT) yang mengautentikasi mereka sebagai pengguna tersebut untuk operasi CRUD lainnya
/verify Mengembalikan id pengguna yang masuk atau 401
policy adalah objek yang menyimpan pasangan nilai kunci yang mengatur bagaimana Komentar Sederhana berperilaku, misalnya menentukan panjang maksimum komentar atau apakah pengguna biasa dapat menghapus dirinya sendiri.
{
isGuestAccountAllowed : boolean , // if true, a visitor can post anonymously using a guest account. if false, only authenticated users can comment.
canFirstVisitCreateTopic : boolean , // if a discussion does not exist for a page, shall it be created when visited for the first time, or does admin create all topics?
canGuestCreateUser : boolean , // can a user with guest credentials create (their own) user profile? if 'canPublicCreateUser' is set to 'true' this setting is ignored
canGuestReadDiscussion : boolean , // can a user with guest credentials browse and read discussions? if 'canPublicReadDiscussion' is set to 'true' this setting is ignored
canGuestReadUser : boolean , // can a user with guest credentials view user profiles? if 'canPublicReadUser' is true, this setting is ignored
canPublicCreateUser : boolean , // can a user with no credentials create (their own) user profile?
canPublicReadDiscussion : boolean , // can a user with no credentials browse and read discussions?
canPublicReadUser : boolean , // can an anonymous visitor view any user's profile?
canUserDeleteSelf : boolean , // can a user delete their own profile?
maxCommentLengthChars : number , // Attempting to post a comment longer than this number of characters will be rejected by the API
} Ada 34 solusi yang bukan Komentar Sederhana yang tercantum di sini. Hampir semuanya lebih matang daripada Simple Comment, dan saya akan merekomendasikan untuk mempertimbangkannya jika Anda tidak mencari solusi khusus tanpa server, sumber terbuka, dan dihosting sendiri. Di bawah ini tercantum pro dan kontra yang membedakannya dari Simple Comment. Jika Kepercayaan diperlukan tercantum, artinya penggunaan layanan memerlukan kepercayaan pada perusahaan, karena mereka akan menyajikan kode sumber tertutup kepada pengguna Anda yang tidak Anda kendalikan dan tidak dapat diperiksa dengan mudah; selain itu, data pengguna akan disimpan di server yang mereka kendalikan. Daftar ini didasarkan pada dokumentasi publik, bukan pengalaman. Jika ada yang salah atau hilang, harap beri tahu saya.
