English | العربية | বাংলা | Bosanski | Deutsch | Español | Français | हिन्दी | Italiano | 日本語 | 한국어 | मराठी | Português | Русский | Kiswahili | தமிழ் | తెలుగు | Türkçe | اردو | Tiếng Việt | 中文

• تعارف
  • مثال
• تنصیب
• خدمات
• مدد
  • $baseUrl
  • $baseParameterMapping
  • $additionalParameters
  • $defaultParameters
  • prepareAttributes()
• سپورٹ کی رہنمائی
  • کمیونٹی کی بنیاد پر مدد
  • کیڑے اور فیچر کی ترجیحات
• لائسنس - MIT لائسنس

🔗تعارف

یہ پیکیج آپ کے لاراول ایپلیکیشن میں شیئر لنکس شامل کرنے کے عمل کو آسان بناتا ہے۔ اگر آپ کو لگتا ہے کہ ہم کسی سروس کو چھوڑ رہے ہیں تو بلا جھجھک ایک پل ریکویسٹ کھولیں!

ایک شیئر لنک ایک یو آر ایل ہوتا ہے جو سماجی میڈیا کی بنیادی یو آر ایل کو آپ کی ویب سائٹ یا ایپ سے مواد شیئر کرنے کے لئے سوالیہ پیرامیٹرز کے ساتھ جوڑتا ہے۔ پیرامیٹرز میں عموماً مواد کا یو آر ایل اور ایک مقررہ پیغام شامل ہوتا ہے۔ یہ لنکس، جو مثالوں میں دکھائے گئے ہیں، صارفین کو ٹوئٹر، فیس بک، اور ٹیلیگرام جیسے پلیٹ فارم پر آسانی سے پوسٹس شیئر کرنے کی اجازت دیتے ہیں۔ اس اوپن سورس پیکیج کا استعمال کریں تاکہ آپ لاراول کے بلیڈ کمپوننٹ سسٹم کے ذریعے جلدی سے شیئر لنکس بنا سکیں۔

🔗مثال

<x-link-sharer service="twitter" text="Share me!" url="https://www.defectivecode.com" hashtags="awesome,links" class="p-4">
    <!-- یہاں اپنا HTML کوڈ شامل کریں تاکہ شیئر بٹن کی شکل و صورت کو کنٹرول کیا جا سکے -->
    <span class="bg-blue-500 hover:bg-blue-700 text-white font-bold py-2 px-4 rounded">کلک کریں!</span>
</x-link-sharer>

🔗تنصیب

1. سب سے پہلے پی ایچ پی پیکیج کو درج ذیل کمپوزر کمانڈ چلا کر انسٹال کریں:

   composer require defectivecode/link-sharer

2. بس اتنا ہی! ہمارا پیکیج لاراول کے پیکیج ڈسکوری کے ذریعے خود بخود انسٹال ہو جائے گا۔

🔗خدمات

سروس فراہم کنندگان بعض اوقات اپنے شیئر لنکس کو پہلے سے اطلاع دیے بغیر اپ ڈیٹ کرتے ہیں۔ ہم ان تبدیلیوں کے ساتھ اپ ڈیٹ رہنے کی ہر ممکن کوشش کرتے ہیں۔ تاہم، اگر آپ غیر فعال سروس کا سامنا کرتے ہیں تو براہ کرم ایک مسئلہ کھولیں یا ایک پل ریکویسٹ جمع کریں۔ نئی سروس کو شامل کرنے کے لئے، نیچے دی گئی مدد سیکشن کا حوالہ دیں۔

کچھ خدمات اضافی پیرامیٹرز فراہم کرتی ہیں جو کمپوننٹ کو منتقل کئے جا سکتے ہیں۔ یہ ذیل کی جدول میں دستاویزی طور پر شامل ہیں۔

سروس	نصیحت کی گئی	یو آر ایل سپورٹ کیا گیا	نوٹس
Blogger	✔️	✔️	t بلاگ پوسٹ کا متن۔
Diaspora	✔️	✔️
Diigo	✔️	✔️	description پوسٹ میں شامل کرنے کے لیے ایک تفصیل۔
Douban	✔️	✔️	comment پوسٹ میں شامل کرنے کے لیے ایک تبصرہ۔
Evernote	✔️	✔️
Facebook	❌	✔️
Flipboard	✔️	✔️	quote پوسٹ میں شامل کرنے کے لیے ایک اقتباس۔
Gmail	✔️	✔️	bcc بی سی سی کے لئے ای میل پتوں کی ایک کاما سے جدا فہرست۔ cc سی سی کے لیے ای میل پتوں کی ایک کاما سے جدا فہرست۔ su ای میل کا مضمون۔ to بھیجنے کے لیے ای میل پتوں کی ایک کاما سے جدا فہرست۔
HackNews	✔️	✔️
Instapaper	✔️	✔️	description پوسٹ کی ایک تفصیل۔
LineMe	❌️	✔️
LinkedIn	❌	✔️
LiveJournal	✔️	✔️
Meneame	❌️	✔️
Okru	❌️	✔️
Outlook	✔️	✔️
Pinterest	✔️	✔️	media پوسٹ پر دکھانے کے لیے ایک تصویر کا یو آر ایل۔
Plurk	❌ ️	✔️
Pocket	✔️	✔️
QZone	✔️	✔️	summary پوسٹ کا خلاصہ۔
Reddit	✔️	✔️
Renren	✔️	✔️	description پوسٹ کی ایک تفصیل۔ srcUrl پوسٹ کا اصل یو آر ایل۔
Skype	✔️	✔️
Telegram	✔️	✔️
Threema	❌	✔️	id اس شخص کا شناختی نمبر جس کو پوسٹ بھیجنا ہے۔
Tumblr	✔️	✔️	caption پوسٹ میں شامل کرنے کے لیے ایک کیپشن۔ tags پوسٹ پر لاگو کرنے کے لیے ٹیگ کی کاما سے جدا فہرست۔
Twitter	✔️	✔️	hashtags ٹوئٹ پر لاگو کرنے کے لیے ہیش ٹیگ کی کاما سے جدا فہرست۔ via جس ٹویٹر کو کریڈٹ دینا ہے۔
Viber	✔️	✔️
VKontakte	✔️	✔️	description پوسٹ کی ایک تفصیل۔ image پوسٹ پر دکھانے کے لیے ایک تصویر کا یو آر ایل۔
Weibo	✔️	✔️
WhatsApp	✔️	✔️
Xing	❌	✔️
YahooMail	✔️	✔️

🔗مدد

ایک سروس شامل کرنا نسبتا آسان ہے۔ src/Services فولڈر میں ایک نئی سروس کلاس بنانا شروع کریں۔ کلاس کا نام آپ جس سروس کو شامل کر رہے ہیں اس کے نام پر رکھیں۔ سسٹم خود بخود فیکٹری کے ذریعے سروس کو رجسٹر کرتا ہے، لہذا دستی رجسٹریشن کی ضرورت نہیں ہے۔

ذیل میں دیا گیا جی میل سروس ایک اچھا مثال ہے۔

<?php
 
namespace DefectiveCode\LinkSharer\Services;
 
use DefectiveCode\LinkSharer\Traits\AppendsLinks;
 
class Gmail extends Service
{
    use AppendsLinks;
 
    protected string $baseUrl = 'https://mail.google.com/mail/u/0';
 
    protected array $baseParameterMapping = [
        'text' => 'body',
    ];
 
    protected array $additionalParameters = [
        'bcc',
        'cc',
        'su',
        'to',
    ];
 
    protected array $defaultParameters = [
        'view' => 'cm',
    ];
}

براہ کرم نوٹ کریں کہ صرف baseUrl لازمی ہے۔ baseParameterMapping, additionalParameters, اور defaultParameters اختیاری ہیں لیکن فعالیت کو بڑھا سکتے ہیں۔

🔗$baseUrl

کسی سروس کا یو آر ایل HTTPS سے شروع ہونے کی ضرورت نہیں ہے۔ مثال کے طور پر، ویبر viber://forward کا استعمال کرتا ہے۔

baseUrl پراپرٹی سروس کی بنیادی یو آر ایل کو مخصوص کرتی ہے۔ یہ یو آر ایل شیئر لنک بنانے کے وقت بنیادی ہوتا ہے، جس پر سوالیہ پیرامیٹرز منسلک کیے جاتے ہیں۔ جی میل کی مثال لیتے ہوئے، اس کا بنیادی یو آر ایل https://mail.google.com/mail/u/0 ہے۔

🔗$baseParameterMapping

اس پیکیج میں دو بنیادی خصوصیات کی شناخت کی جاتی ہے: text اور url، کیونکہ یہ زیادہ تر سروس فراہم کنندگان میں عام ہیں۔ ان خصوصیات کو صرف اسی صورت میں بیان کریں جب متعلقہ سروس مختلف ناموں کی روایات کا استعمال کرتی ہو۔ مثلاً، جی میل text کے بجائے body کا استعمال کرتا ہے، جس کے نتیجے میں یہ واضح میپنگ ضروری ہوتی ہے۔ جب جی میل کا استعمال کیا جاتا ہے، تو بلیڈ کمپوننٹ کے لیے فراہم کردہ کوئی بھی text خصوصیت شیئر لنک میں body سوالیہ پیرامیٹر میں تبدیل ہو جاتی ہے۔

🔗$additionalParameters

کچھ خدمات مزید مخصوص سوالیہ پیرامیٹرز قبول کرتی ہیں۔ جی میل کو ایک حوالہ کے طور پر لیتے ہوئے، یہ bcc, cc, su, اور to کی حمایت کرتا ہے۔ ان کو additionalParameters کی فہرست میں بیان کریں۔ جب صارفین ان خصوصیات کو بلیڈ کمپوننٹ میں شامل کرتے ہیں، تو یہ شیئر لنک میں شامل ہو جاتے ہیں۔ یقینی بنائیں کہ یہ پیرامیٹر بھی موجودہ خدمات ٹیبل میں مختصر وضاحت کے ساتھ درج ہیں۔

🔗$defaultParameters

کچھ خدمات کو شیئر لنک کے کام کرنے کے لیے مخصوص سوالیہ پیرامیٹرز کی ضرورت ہوتی ہے۔ مثال کے طور پر، جی میل کو view=cm شامل کرنا ضروری ہے۔ ایسے واجب الخصوصات کو defaultParameters کی فہرست میں بیان کیا جاتا ہے۔ یہ ہمیشہ شیئر لنک میں شامل کیے جاتے ہیں اور انہیں چھوڑا نہیں جا سکتا۔

🔗prepareAttributes()

خصوصیات کو شیئر لنک بنانے سے پہلے ہی تبدیل کرنے کے لیے، اپنی سروس میں ایک prepareAttributes میتھڈ شامل کریں۔ یہ میتھڈ generateLink میتھڈ میں خصوصیات کو پاس کرنے سے پہلے ایکٹیویٹ ہوتی ہے، جو کہ حسب ضرورت میں خصوصیات میں تبدیلی کی اجازت دیتی ہے۔ ذیل میں AppendsLinks ٹریٹ کا استعمال کرتے ہوئے ایک مظاہرہ دیا گیا ہے۔

<?php
 
namespace DefectiveCode\LinkSharer\Traits;
 
trait AppendsLinks
{
    protected function prepareAttributes(): void
    {
        if (isset($this->attributes['text']) && isset($this->attributes['url'])) {
            $this->attributes['text'] = $this->attributes['text'] . "\n" . $this->attributes['url'];
            return;
        }
 
        if (isset($this->attributes['url'])) {
            $this->attributes['text'] = $this->attributes['url'];
        }
    }
}

سروس میں منتقل کردہ خصوصیات $attributes کی فہرست کے ذریعے دستیاب ہیں۔ دیے گئے مثال میں:

• اگر دونوں text اور url خصوصیات موجود ہیں، تو url text خصوصیت میں شامل کی جاتی ہے۔
• اگر صرف url خصوصیت دستیاب ہے، تو text خصوصیت url کی قیمت اختیار کر لیتی ہے۔

🔗سپورٹ کی رہنمائی

ہمارے اوپن سورس پیکیج کا انتخاب کرنے کے لیے شکریہ! براہ کرم ان سپورٹ رہنما خطوط پر ایک لمحہ صرف کریں۔ یہ آپ کو ہمارے پروجیکٹ سے زیادہ سے زیادہ فائدہ اٹھانے میں مدد کریں گے۔

🔗کمیونٹی کی بنیاد پر مدد

ہمارا اوپن سورس پروجیکٹ ہماری شاندار کمیونٹی کی مدد سے چلتا ہے۔ اگر آپ کے پاس سوالات ہیں یا مدد کی ضرورت ہے تو، StackOverflow اور دیگر آن لائن وسائل آپ کے بہترین دوست ہیں۔

🔗کیڑے اور فیچر کی ترجیحات

اوپن سورس پروجیکٹ کا انتظام کرنے کی حقیقت یہ ہے کہ ہم ہر رپورٹ شدہ کیڑے یا فیچر کی درخواست کو فوری طور پر نہیں حل کر سکتے۔ ہم مسائل کو درج ذیل ترتیب میں ترجیح دیتے ہیں:

1. ہماری ادائیگی شدہ مصنوعات پر اثر انداز ہونے والے کیڑے

وہ کیڑے جو ہماری ادائیگی شدہ مصنوعات پر اثر انداز ہوتے ہیں ہمیشہ ہماری پہلی ترجیح ہوں گے۔ کچھ معاملات میں، ہم صرف ان کیڑوں کو حل کریں گے جو براہ راست ہمیں متاثر کرتے ہیں۔

2. کمیونٹی کی طرف سے پول ریگسٹس

اگر آپ نے کسی کیڑے کی نشاندہی کی ہے اور آپ کے پاس حل ہے، تو براہ کرم پول ریگسٹس جمع کرائیں۔ اپنی مصنوعات سے متعلق مسائل کے بعد، ہم ان کمیونٹی کی بنیاد پر درستگیوں کو اگلی سب سے بڑی ترجیح دیتے ہیں۔ جائزہ لینے اور منظور ہونے کے بعد، ہم آپ کے حل کو ضم کریں گے اور آپ کی شراکت کو تسلیم کریں گے۔

3. مالی مدد

ذکر کردہ زمرے سے باہر کے مسائل کے لیے، آپ ان کا حل کرنے کے لئے مالی امداد فراہم کرنے کا انتخاب کر سکتے ہیں۔ ہر اوپن مسئلہ ایک آرڈر فارم سے منسلک ہے جہاں آپ مالی طور پر تعاون کر سکتے ہیں۔ ہم ان مسائل کو فراہم کردہ فنڈنگ کی رقم کی بنیاد پر ترجیح دیتے ہیں۔

کمیونٹی کی شراکتیں

اوپن سورس اس وقت بڑھتا ہے جب اس کی کمیونٹی فعال ہو۔ چاہے آپ کیڑے حل نہیں کر رہے ہوں، کوڈ کی بہتریوں، دستاویز کے اپ ڈیٹس، سبقیں، یا کمیونٹی چینلز میں دوسروں کی مدد کے ذریعے شراکت دینے پر غور کریں۔ ہم بالعموم سب کو، ایک کمیونٹی کے طور پر، اوپن سورس کام کی مدد کرنے کی ترغیب دیتے ہیں۔

دوہرانے کے لیے، DefectiveCode کیڑے کو اس بنیاد پر ترجیح دے گا کہ وہ ہمارے ادائیگی شدہ پروڈکٹس، کمیونٹی کی پول ریگسٹس اور مسائل کے لئے موصولہ مالی مدد پر کس طرح اثر انداز ہوتے ہیں۔

🔗لائسنس - MIT لائسنس

کاپی رائٹ © Defective Code, LLC. تمام حقوق محفوظ ہیں

یہاں پر کسی بھی شخص کو یہ سافٹ ویئر اور اس سے وابستہ دستاویزات کی کاپی حاصل کرنے کی اجازت دی جاتی ہے (جسے "سافٹ ویئر" کہا جاتا ہے)، تاکہ وہ سافٹ ویئر میں کسی بھی پابندی کے بغیر کام کر سکے، بشمول بغیر کسی حد کے، استعمال کرنے، کاپی کرنے، ترمیم کرنے، یکجا کرنے، شائع کرنے، تقسیم کرنے، ذیلی لائسنس دینے اور/یا سافٹ ویئر کی کاپیوں کو بیچنے کے حقوق حاصل کرنے، اور ان لوگوں کو اجازت دینے کا کہ جنہیں سافٹ ویئر فراہم کیا گیا ہے، کہ وہ ایسا کرسکیں، مندرجہ ذیل شرائط کے تابع:

اوپر کا کاپی رائٹ نوٹس اور یہ اجازت نامہ سافٹ ویئر کی تمام کاپیوں یا اہم حصوں میں شامل کیا جائے گا۔

یہ سافٹ ویئر "جیسا ہے" فراہم کیا جاتا ہے، بغیر کسی قسم کی وارنٹی، واضح یا مضمر، بشمول لیکن محدود نہیں، مارکیٹ ایبیلٹی، کسی خاص مقصد کے لئے موزونیت اور خلاف ورزی کے وارنٹیوں کے۔ کسی بھی صورت میں مصنفین یا کاپی رائٹ ہولڈرز کسی بھی دعوے، نقصانات یا دیگر ذمہ داریوں کے لئے ذمہ دار نہیں ہوں گے، چاہے وہ معاہدے کے ایکشن، غلطی یا کسی اور طریقے سے ہو، جو سافٹ ویئر یا سافٹ ویئر کے استعمال یا دیگر معاملات سے پیدا ہو، یا اس سے متعلق ہو۔