الأصول الثابتة

دليل لفهم كيفية تقديم الأصول الثابتة في إطار عمل Frappe.

مجلد الأصول

يتم تقديم الملفات الثابتة من مجلد frappe-bench/sites/assets. عند إعداد frappe لنشر الإنتاج، يخدم nginx هذا المجلد مباشرة. تبدأ جميع عناوين URL للملفات الثابتة دائمًا بـ /assets. يمكن الوصول إلى ملف في الموقع frappe-bench/sites/assets/hero.png للجمهور عبر عنوان URL /assets/hero.png.

المجلد العام

كل تطبيق له مجلد public الخاص به والذي يمكن استخدامه لتقديم أصول ثابتة. هذا المجلد مرتبط برمزياً بـ frappe-bench/sites/assets/[appname]. هذا هو إخراج أمر tree على مجلد assets.

~/frappe-bench
$ tree sites/assets -L 1
sites/assets
├── erpnext -> ~/frappe-bench/apps/erpnext/erpnext/public
└── frappe -> ~/frappe-bench/apps/frappe/frappe/public

هذا يعني إذا كان هناك ملف في [appname]/public/images/favicon.png، فإنه يوجد أيضًا كرابط رمزي في assets/[appname]/images/favicon.png ويمكن الوصول إليه للجمهور عبر عنوان URL /assets/[appname]/images/favicon.png.

الأصول المجمعة

يتم إنشاء الأصول المجمعة في assets/[appname]/dist/js و assets/[appname]/dist/css. وبالتالي، يمكن الوصول إليها عبر عنوان URL /assets/[appname]/dist/js/main.bundle.[hash].js.

أصول الموقع

بالإضافة إلى الملفات الثابتة المقدمة من التطبيقات، يمكن أن يكون لكل موقع ملفاته الثابتة الخاصة التي قد تأتي من تحميلات المستخدم أو النسخ الاحتياطية للموقع.

رفعات المستخدم

الملفات التي يرفعها المستخدم وهي عامة مخزنة في frappe-bench/sites/[sitename]/public/files. يمكن الوصول إلى ملف مخزن في frappe-bench/sites/[sitename]/public/files/profile.png للجمهور عبر عنوان URL /files/profile.png.

الملفات التي يرفعها المستخدم وهي خاصة مخزنة في frappe-bench/sites/[sitename]/private/files. يمكن الوصول إلى ملف مخزن في frappe-bench/sites/[sitename]/private/files/profile.png عبر عنوان URL /private/files/profile.png. يمكن الوصول إلى الملفات الخاصة فقط عندما يكون المستخدم مخولاً لعرضها.

النسخ الاحتياطية

أي نسخ احتياطية محلية يتم إنشاؤها للموقع مخزنة كـ frappe-bench/sites/[sitename]/private/backups/20210502_182223-[sitename]-database.sql.gz. يمكن الوصول إليها عبر عنوان URL /backups/20210502_182223-[sitename]-database.sql.gz وفقط عندما يكون المستخدم مخولاً لتنزيلها.

هذا هو إخراج أمر ls:

~/frappe-bench
$ ls -l sites/site1.test/private/backups
total 6160
-rw-r--r-- 1 farisansari staff 2429268 May 2 18:22 20210502_182223-site1_test-database.sql.gz
-rw-r--r-- 1 farisansari staff 278 May 2 18:22 20210502_182223-site1_test-site_config_backup.json