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

# भाषांतर चेतावणी

हे दस्तऐवज स्वयंचलितपणे अनुवादित केले गेले आहे. जर अनुवादात त्रुटी असतील तर कृपया प्रकल्पावर पुल विनंती उघडा आणि अनुवादित फाइल docs/{ISO 639-1 Code}.md मध्ये जोडा.

# परिचय

हे पॅकेज तुमच्या Laravel अनुप्रयोगात शेअर लिंक जोडण्याची प्रक्रिया सुलभ करते. जर तुम्हाला एखादी सेवा गहाळ असल्याचे आढळल्यास, कृपया एक पुल विनंती उघडा!

शेअर लिंक ही एक URL आहे जी सोशल मीडिया बेस URL ला तुमच्या वेबसाइट किंवा अॅपमधून सामग्री शेअर करण्यासाठी क्वेरी पॅरामीटर्ससह एकत्र करते. पॅरामीटर्समध्ये सामान्यतः सामग्री URL आणि एक पूर्वनिर्धारित संदेश समाविष्ट असतो. या उदाहरणांमध्ये दाखवल्याप्रमाणे, या लिंक वापरकर्त्यांना Twitter, Facebook, आणि Telegram सारख्या प्लॅटफॉर्मवर पोस्ट्स सहजपणे शेअर करण्याची परवानगी देतात. Laravel च्या ब्लेड घटक प्रणालीद्वारे शेअर लिंक जलदपणे तयार करण्यासाठी हे मुक्त-स्रोत पॅकेज वापरा.

• उदाहरण
• सेवा
• योगदान
  • $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 कमांड चालवून PHP पॅकेज स्थापित करा:

   composer require defectivecode/link-sharer

2. बस! आमचे पॅकेज Laravel च्या पॅकेज डिस्कवरीचा वापर करून आपोआप स्थापित होईल.

🔗सेवा

सेवा प्रदाते पूर्व सूचना न देता आपल्या शेअर लिंक्स अद्ययावत करतात. आम्ही या बदलांसह अद्ययावत राहण्याचा सर्वतोपरी प्रयत्न करतो. तथापि, जर तुम्हाला कोणतीही सेवा कार्यरत नसल्याचे आढळले, तर कृपया एक समस्या उघडा किंवा एक पुल विनंती सबमिट करा. नवीन सेवा जोडण्यासाठी, खालील योगदान विभाग पहा.

काही सेवा अतिरिक्त पॅरामीटर्स प्रदान करतात जे घटकाला पास केले जाऊ शकतात. हे खालील तक्त्यात दस्तऐवजीकरण केलेले आहे.

सेवा	मजकूर समर्थित	URL समर्थित	टीप
ब्लॉगर	✔️	✔️	t ब्लॉग पोस्टचा मजकूर.
डायस्पोरा	✔️	✔️
डिगो	✔️	✔️	description पोस्टमध्ये जोडण्यासाठी वर्णन.
डौबान	✔️	✔️	comment पोस्टमध्ये जोडण्यासाठी टिप्पणी.
एव्हरनोट	✔️	✔️
फेसबुक	❌	✔️
फ्लिपबोर्ड	✔️	✔️	quote पोस्टमध्ये जोडण्यासाठी उद्धरण.
जीमेल	✔️	✔️	bcc बीसीसी करण्यासाठी ईमेल पत्त्यांची अल्पविरामाने विभाजित यादी. cc सीसी करण्यासाठी ईमेल पत्त्यांची अल्पविरामाने विभाजित यादी. su ईमेलचा विषय. to पाठवण्यासाठी ईमेल पत्त्यांची अल्पविरामाने विभाजित यादी.
हॅकन्यूज	✔️	✔️
इंस्टापेपर	✔️	✔️	description पोस्टचे वर्णन.
लाइनमी	❌️	✔️
लिंक्डइन	❌	✔️
लाइव्हजर्नल	✔️	✔️
मेनेमे	❌️	✔️
ओक्रू	❌️	✔️
आउटलुक	✔️	✔️
पिंटरेस्ट	✔️	✔️	media पोस्टवर दाखवण्यासाठी प्रतिमेचा URL.
प्लर्क	❌ ️	✔️
पॉकेट	✔️	✔️
क्यूझोन	✔️	✔️	summary पोस्टचा सारांश.
रेडिट	✔️	✔️
रेनरेन	✔️	✔️	description पोस्टचे वर्णन. srcUrl पोस्टचा मूळ URL.
स्काईप	✔️	✔️
टेलीग्राम	✔️	✔️
थ्रीमा	❌	✔️	id पोस्ट पाठवण्यासाठी व्यक्तीचा आयडी.
टंबलर	✔️	✔️	caption पोस्टमध्ये जोडण्यासाठी कॅप्शन. tags पोस्टला लागू करण्यासाठी अल्पविरामाने विभाजित टॅग्सची यादी.
ट्विटर	✔️	✔️	hastags ट्विटला लागू करण्यासाठी अल्पविरामाने विभाजित हॅश टॅग्सची यादी. via श्रेय देण्यासाठी ट्विट करणारा.
व्हायबर	✔️	✔️
व्हीकोंटाक्ट	✔️	✔️	description पोस्टचे वर्णन. image पोस्टवर दाखवण्यासाठी प्रतिमेचा URL.
वेइबो	✔️	✔️
व्हॉट्सअॅप	✔️	✔️
झिंग	❌	✔️
याहूमेल	✔️	✔️

🔗योगदान

सेवा जोडणे तुलनेने सोपे आहे. src/Services फोल्डरमध्ये नवीन सेवा वर्ग तयार करून प्रारंभ करा. तुम्ही जोडत असलेल्या सेवेनुसार वर्गाचे नाव ठेवा. प्रणाली स्वयंचलितपणे फॅक्टरीद्वारे सेवेला नोंदणीकृत करते, त्यामुळे मॅन्युअल नोंदणीची गरज नाही.

खाली दिलेली Gmail सेवा एक चांगले उदाहरण आहे.

<?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 viber://forward वापरतो.

baseUrl प्रॉपर्टी सेवेसाठी प्राथमिक URL निर्दिष्ट करते. हा URL शेअर लिंक तयार करताना मूलभूत असतो, ज्यामध्ये क्वेरी पॅरामीटर्स जोडले जातात. Gmail च्या उदाहरणाचा वापर करून, त्याचा बेस URL https://mail.google.com/mail/u/0 आहे.

🔗$baseParameterMapping

या पॅकेजमध्ये दोन प्राथमिक गुणधर्म ओळखले जातात: text आणि url, कारण ते बहुतेक सेवा प्रदात्यांमध्ये सामान्य आहेत. फक्त या गुणधर्मांची व्याख्या करा जर संबंधित सेवा वेगळ्या नामकरण पद्धतीचा वापर करत असेल. उदाहरणार्थ, Gmail text च्या जागी body वापरतो, ज्यामुळे ही स्पष्ट मॅपिंग आवश्यक आहे. Gmail वापरताना, ब्लेड घटकाला पास केलेला कोणताही text गुणधर्म शेअर लिंकमध्ये body क्वेरी पॅरामीटरमध्ये रूपांतरित होतो.

🔗$additionalParameters

काही सेवा अधिक विशिष्ट क्वेरी पॅरामीटर्स स्वीकारतात. Gmail चा संदर्भ घेतल्यास, तो bcc, cc, su, आणि to ला समर्थन देतो. हे additionalParameters अॅरेमध्ये परिभाषित करा. जेव्हा वापरकर्ते ब्लेड घटकात हे गुणधर्म समाविष्ट करतात, तेव्हा ते शेअर लिंकमध्ये जोडले जातात. हे पॅरामीटर्स देखील समर्थित सेवांमध्ये टेबलमध्ये सूचीबद्ध असल्याचे सुनिश्चित करा, संक्षिप्त वर्णनांसह.

🔗$defaultParameters

काही सेवा शेअर लिंक कार्य करण्यासाठी विशिष्ट क्वेरी पॅरामीटर्सची आवश्यकता असते. उदाहरणार्थ, Gmail ला 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 आमच्या सशुल्क उत्पादनांवर, समुदाय पुल विनंत्यांवर आणि समस्यांसाठी प्राप्त झालेल्या आर्थिक समर्थनावर आधारित बग्सना प्राधान्य देईल.

# परवाना - एमआयटी परवाना

कॉपीराइट © डिफेक्टिव कोड, एलएलसी. सर्व हक्क राखीव

या सॉफ्टवेअरची आणि संबंधित दस्तऐवजीकरण फाइल्सची (यापुढे "सॉफ्टवेअर") प्रत मिळवणाऱ्या कोणत्याही व्यक्तीस, शुल्क न आकारता, सॉफ्टवेअरचा वापर, प्रत, सुधारणा, विलीन, प्रकाशित, वितरण, उप-परवाना आणि/किंवा सॉफ्टवेअरच्या प्रत विकण्याचे अधिकार, आणि ज्यांना सॉफ्टवेअर पुरवले जाते त्यांना हे करण्याची परवानगी देण्याचे अधिकार, कोणत्याही निर्बंधाशिवाय, यासह परवानगी दिली जाते.

वरील कॉपीराइट नोटीस आणि ही परवानगी सूचना सॉफ्टवेअरच्या सर्व प्रतिंमध्ये किंवा महत्त्वपूर्ण भागांमध्ये समाविष्ट केली पाहिजे.

सॉफ्टवेअर "जसे आहे" तशाच स्थितीत पुरवले जाते, कोणत्याही प्रकारची हमी न देता, स्पष्ट किंवा अप्रत्यक्ष, यासह परंतु मर्यादित नाही, विक्रीयोग्यता, विशिष्ट उद्देशासाठी उपयुक्तता आणि उल्लंघन न होण्याच्या हमींसह. कोणत्याही परिस्थितीत लेखक किंवा कॉपीराइट धारक कोणत्याही दाव्यासाठी, नुकसानासाठी किंवा इतर कोणत्याही जबाबदारीसाठी, करारात, अत्याचारात किंवा अन्यथा, सॉफ्टवेअरमधून किंवा सॉफ्टवेअरच्या वापरातून किंवा इतर व्यवहारांमधून उद्भवणाऱ्या, जबाबदार राहणार नाहीत.