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

# ترجمہ کی وارننگ

یہ دستاویز خودکار طور پر ترجمہ کی گئی ہے۔ اگر اس میں ترجمے کی غلطیاں ہیں تو براہ کرم پروجیکٹ پر پُل ریکویسٹ کھولیں اور ترجمہ شدہ فائل کو docs/{ISO 639-1 Code}.md میں شامل کریں۔

# تعارف

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

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

• مثال
• تنصیب
• خدمات
• تعاون
  • $baseUrl
  • $baseParameterMapping
  • $additionalParameters
  • $defaultParameters
  • prepareAttributes()
• معاونت کے رہنما اصول
  • کمیونٹی کی زیر قیادت معاونت
  • بگز اور فیچر کی ترجیح

🔗مثال

<x-link-sharer service="twitter" text="مجھے شیئر کریں!" 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. بس! ہمارا پیکج خود بخود لیراول کے پیکج ڈسکوری کا استعمال کرتے ہوئے انسٹال ہو جائے گا۔

🔗خدمات

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

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

سروس	ٹیکسٹ سپورٹڈ	یو آر ایل سپورٹڈ	نوٹس
بلاگر	✔️	✔️	t بلاگ پوسٹ کا متن۔
ڈائیسپورا	✔️	✔️
ڈیگو	✔️	✔️	description پوسٹ میں شامل کرنے کے لیے ایک تفصیل۔
ڈوبان	✔️	✔️	comment پوسٹ میں شامل کرنے کے لیے ایک تبصرہ۔
ایورنوٹ	✔️	✔️
فیس بک	❌	✔️
فلپ بورڈ	✔️	✔️	quote پوسٹ میں شامل کرنے کے لیے ایک اقتباس۔
جی میل	✔️	✔️	bcc بی سی سی کرنے کے لیے ای میل پتوں کی کاما سے جدا فہرست۔ cc سی سی کرنے کے لیے ای میل پتوں کی کاما سے جدا فہرست۔ su ای میل کا موضوع۔ to بھیجنے کے لیے ای میل پتوں کی کاما سے جدا فہرست۔
ہیک نیوز	✔️	✔️
انسٹا پیپر	✔️	✔️	description پوسٹ کی تفصیل۔
لائن می	❌️	✔️
لنکڈ ان	❌	✔️
لائیو جرنل	✔️	✔️
مینیامے	❌️	✔️
اوکر	❌️	✔️
آؤٹ لک	✔️	✔️
پنٹرسٹ	✔️	✔️	media پوسٹ پر دکھانے کے لیے ایک تصویر کا یو آر ایل۔
پلرک	❌ ️	✔️
پاکٹ	✔️	✔️
کیو زون	✔️	✔️	summary پوسٹ کا خلاصہ۔
ریڈٹ	✔️	✔️
رینرن	✔️	✔️	description پوسٹ کی تفصیل۔ srcUrl پوسٹ کا اصل یو آر ایل۔
اسکائپ	✔️	✔️
ٹیلیگرام	✔️	✔️
تھریما	❌	✔️	id پوسٹ بھیجنے والے شخص کا آئی ڈی۔
ٹمبلر	✔️	✔️	caption پوسٹ میں شامل کرنے کے لیے ایک کیپشن۔ tags پوسٹ پر لاگو کرنے کے لیے ٹیگز کی کاما سے جدا فہرست۔
ٹویٹر	✔️	✔️	hastags ٹویٹ پر لاگو کرنے کے لیے ہیش ٹیگز کی کاما سے جدا فہرست۔ via کریڈٹ دینے کے لیے ٹویٹر۔
وائبر	✔️	✔️
وی کونٹاکٹے	✔️	✔️	description پوسٹ کی تفصیل۔ image پوسٹ پر دکھانے کے لیے ایک تصویر کا یو آر ایل۔
ویبو	✔️	✔️
واٹس ایپ	✔️	✔️
زنگ	❌	✔️
یاہو میل	✔️	✔️

🔗تعاون

ایک سروس شامل کرنا نسبتاً سیدھا ہے۔ 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

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

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

🔗$baseParameterMapping

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

🔗$additionalParameters

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

🔗$defaultParameters

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

🔗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 array کے ذریعے قابل رسائی ہیں۔ دی گئی مثال میں:

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

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

  🔗معاونت کے رہنما اصول

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

🔗کمیونٹی کی زیر قیادت معاونت

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

🔗بگز اور فیچر کی ترجیح

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

1. ہمارے پیڈ پروڈکٹس کو متاثر کرنے والے بگز

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

2. کمیونٹی پل ریکویسٹ

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

3. مالی معاونت

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

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

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

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

# لائسنس - ایم آئی ٹی لائسنس

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

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

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

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