README_FA.md

⚠️ این پروژه به این صفحه منتقل شده است

لینکدونی‌فسفر

این پروژه کلونی ساده از وبسایت معروف Hacker News با استفاده از فریمورک لاراول ۷ و بوت‌استرپ ۴ است و هم‌اکنون در حال توسعه در بخش‌های اساسی می‌باشد. (هنوز تمامی نیازمندی‌های اصلی پروژه پیاده‌سازی نشده است)

این پروژه فعلا تنها به زبان فارسی در دسترس است اما بزودی زبان‌های دیگر نیز به آن اضافه می‌شود.

چیستی !

این وبسایت همانند سایت معروف Hacker News جاییست که افراد، با تفکرات متفاوت میتونن لینک‌هایی که به نظرشون در طول روز مفید هست رو با دیگران به اشتراک بگذارند. همچنین کاربران توانایی ساخت لیست‌های مختلف از لینک‌ها، رای دهی به هر لینک، نظرگذاری برای هر لینک و ... را دارند. وبسایت‌هایی با این کارایی برای شناساندن مطالب جدید و سایت‌ها و ابزار‌های اوپن سورس ساخته شده جدید بسیار کاربرد دارند. وجود API رایگان در این پروژه میتواند برای افراد علاقمند به تکنولوژی بسیار پر کاربرد باشد. مهم تر از همه این برنامه محلیست برای یادگیری و تجربه‌های جدید پس همیشه مسیر برای همکاری شما در این پروژه هموار خواهد بود :)

اجرا

قبل از اجرای این برنامه شما نیاز به نصب docker و docker-compose دارید. بعد از اطمینان از نصب نیازمندیها طبق دستور العمل زیر پروژه را اجرا کنید.

1. پروژه را با دستور زیر در سیستم ذخیره کنید.

   git clone https://github.com/sadraiiali/FOSS4News.git && cd FOSS4News
   

2. با اجرای دستور زیر فایل src/.env ساخته می‌شود. در این فایل و یا فایل docker-compose.yml شما میتوانید تنظیمات خود را انجام دهید. به صورت پیشفرض تنها نیاز است در فایل docker-compose.yml دو متغییر APP_URL (برای آدرس سایت خود) و متغیر APP_NAME (برای نام سایت خود) تعویض کنید.

   bash ./RunFirstTime.sh
   

3. تغییرات خود را انجام داده و با اجرای دوباره دستور قبلی پروژه شروع به بیلد شدن می‌کند و بعد از چند دقیقه سایت شما آماده است.

   به صورت پیشفرض برای تست کارایی سیستم دوکاربر زیر در سیستم ساخته شده است. شما میتوانید با ساختن کاربری جدید و با استفاده از کاربر ادمین دیفالت، خود را ادمین کرده و آن دو کاربر دیگر را حذف کنید.

   user:password
   کاربر عادی : [email protected]:testtest
   کاربر ادمین :‌ [email protected]:adminadmin
   

تکنولوژی‌های استفاده شده

• لاراول ۷ - فریمورک زبان PHP
• Bootstrap4 - ابزار طراحی فرانت‌اند
• یه کمی هم PHP و JS و HTML و SASS و ... ا (▲ᴗ▲)

مشارکت

این پروژه، پروژه‌ای آزاد و متن‌باز بوده و مشارکت در آن منحصر به فرد یا گروهی نیست. هر کس با هر سطح دانش میتواند نقشی در پیشبرد این پروژه داشته باشد. ولی حتما قبل از این که دست به کد بشین لطفا اول صفحه‌ی شیوه‌ی مشارکت رو مطالعه کنید و همینطور اولویت‌های پروژه در این صفحه قابل مشاهده هستند. در آخر اگر سوالی در خصوص این پروژه داشتین، خجالت نکشین و بپرسین ♥‿♥

توسعه‌دهندگان

• علیرضا صدرایی راد [تلگرام]
• مهران

لایسنس‌ها

کدهای اصلی این پروژه تحت لایسنس GPLv3 منتشر شده است. اما فریمورک‌ها و کتابخانه‌های مورد استفاده از لایسنس خود پیروی می‌کنند.

این به این معنی هست که کپی کردن از این پروژه نه تنها بد نیست بلکه بسیار پسندیده و بجاست. فقط حواستون باشه که شما هم باید کپی برنامتون رو مثل من اوپن سورس کنید ✌(-‿-)✌