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="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">Click me!</span>
</x-link-sharer>

# ఇన్‌స్టాలేషన్

1. మొదట PHP ప్యాకేజీని క్రింది కంపోజర్ కమాండ్‌ని నడిపించి ఇన్‌స్టాల్ చేయండి:

   composer require defectivecode/link-sharer

2. అంతే! మా ప్యాకేజీ లారావెల్ యొక్క ప్యాకేజీ డిస్కవరీని ఉపయోగించి ఆటోమేటిక్‌గా ఇన్‌స్టాల్ అవుతుంది.

🔗సేవలు

సేవా ప్రదాతలు అప్పుడప్పుడు తమ షేర్ లింకులను ముందస్తు నోటీసు లేకుండా నవీకరిస్తారు. ఈ మార్పులతో అప్‌డేట్‌గా ఉండటానికి మేము అన్ని ప్రయత్నాలు చేస్తాము. అయితే, మీరు పనిచేయని సేవను ఎదుర్కొంటే, దయచేసి ఒక ఇష్యూ తెరవండి లేదా పుల్ రిక్వెస్ట్ సమర్పించండి. కొత్త సేవను జోడించడానికి, దిగువ contributing విభాగాన్ని చూడండి.

కొన్ని సేవలు కాంపోనెంట్‌కు పంపవచ్చు అదనపు పారామీటర్లను అందిస్తాయి. ఇవి దిగువ పట్టికలో డాక్యుమెంట్ చేయబడ్డాయి.

సేవ	టెక్స్ట్ మద్దతు	URL మద్దతు	గమనికలు
బ్లాగర్	✔️	✔️	t బ్లాగ్ పోస్ట్ యొక్క టెక్స్ట్.
డయాస్పోరా	✔️	✔️
డీగో	✔️	✔️	description పోస్ట్‌కు జోడించడానికి వివరణ.
డౌబాన్	✔️	✔️	comment పోస్ట్‌కు జోడించడానికి వ్యాఖ్య.
ఎవర్‌నోట్	✔️	✔️
ఫేస్‌బుక్	❌	✔️
ఫ్లిప్‌బోర్డ్	✔️	✔️	quote పోస్ట్‌కు జోడించడానికి కోట్.
జీమెయిల్	✔️	✔️	bcc BCC చేయడానికి ఇమెయిల్ చిరునామాల యొక్క కామా-విభజిత జాబితా. cc CC చేయడానికి ఇమెయిల్ చిరునామాల యొక్క కామా-విభజిత జాబితా. su ఇమెయిల్ యొక్క విషయం. to పంపడానికి ఇమెయిల్ చిరునామాల యొక్క కామా-విభజిత జాబితా.
హాక్‌న్యూస్	✔️	✔️
ఇన్‌స్టాపేపర్	✔️	✔️	description పోస్ట్ యొక్క వివరణ.
లైన్‌మీ	❌️	✔️
లింక్డ్ఇన్	❌	✔️
లైవ్‌జర్నల్	✔️	✔️
మెనేమే	❌️	✔️
ఓక్రు	❌️	✔️
అవుట్‌లుక్	✔️	✔️
పింటరెస్ట్	✔️	✔️	media పోస్ట్‌లో చూపించడానికి ఒక చిత్రం URL.
ప్లర్క్	❌ ️	✔️
పాకెట్	✔️	✔️
క్యుజోన్	✔️	✔️	summary పోస్ట్ యొక్క సారాంశం.
రెడిట్	✔️	✔️
రెన్‌రెన్	✔️	✔️	description పోస్ట్ యొక్క వివరణ. srcUrl పోస్ట్ యొక్క అసలు URL.
స్కైప్	✔️	✔️
టెలిగ్రామ్	✔️	✔️
త్రీమా	❌	✔️	id పోస్ట్ పంపడానికి వ్యక్తి యొక్క ID.
టంబ్లర్	✔️	✔️	caption పోస్ట్‌కు జోడించడానికి శీర్షిక. tags పోస్ట్‌కు వర్తింపజేయడానికి కామా-విభజిత ట్యాగ్‌ల జాబితా.
ట్విట్టర్	✔️	✔️	hastags ట్వీట్‌కు వర్తింపజేయడానికి కామా-విభజిత హ్యాష్ ట్యాగ్‌ల జాబితా. via క్రెడిట్ ఇవ్వడానికి ట్వీటర్.
వైబర్	✔️	✔️
వీకాంటాక్టే	✔️	✔️	description పోస్ట్ యొక్క వివరణ. image పోస్ట్‌లో చూపించడానికి ఒక చిత్రం URL.
వెబో	✔️	✔️
వాట్సాప్	✔️	✔️
జింగ్	❌	✔️
యాహూ మెయిల్	✔️	✔️

# సహకారం
 
సేవను జోడించడం తేలికైన పని. `src/Services` ఫోల్డర్‌లో కొత్త సేవా తరగతిని సృష్టించడం ప్రారంభించండి. మీరు జోడిస్తున్న సేవకు తరగతికి పేరు పెట్టండి. వ్యవస్థ స్వయంచాలకంగా ఫ్యాక్టరీ ద్వారా సేవను నమోదు చేస్తుంది, కాబట్టి మాన్యువల్ రిజిస్ట్రేషన్ అవసరం లేదు.
 
క్రింద ఇవ్వబడిన Gmail సేవ మంచి ఉదాహరణగా పనిచేస్తుంది.
 
```php
<?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 విలువను స్వీకరిస్తుంది.

 
 
```markdown
# మద్దతు మార్గదర్శకాలు
 
మా ఓపెన్ సోర్స్ ప్యాకేజీని ఎంచుకున్నందుకు ధన్యవాదాలు! దయచేసి ఈ మద్దతు మార్గదర్శకాలను చూడటానికి ఒక క్షణం తీసుకోండి. ఇవి మా ప్రాజెక్ట్ నుండి మీకు ఎక్కువ ప్రయోజనం పొందడంలో సహాయపడతాయి.
 
## కమ్యూనిటీ ఆధారిత మద్దతు
 
మా ఓపెన్ సోర్స్ ప్రాజెక్ట్ మా అద్భుతమైన కమ్యూనిటీ ద్వారా నడపబడుతుంది. మీకు ప్రశ్నలు లేదా సహాయం అవసరమైతే, StackOverflow మరియు ఇతర ఆన్‌లైన్ వనరులు మీకు ఉత్తమ ఎంపికలు.
 
## బగ్స్ మరియు ఫీచర్ ప్రాధాన్యత
 
ఓపెన్ సోర్స్ ప్రాజెక్ట్‌ను నిర్వహించడం అంటే ప్రతి నివేదించబడిన బగ్ లేదా ఫీచర్ అభ్యర్థనను తక్షణమే పరిష్కరించలేమని వాస్తవం. మేము సమస్యలను కింది క్రమంలో ప్రాధాన్యత ఇస్తాము:
 
### 1. మా చెల్లింపు ఉత్పత్తులను ప్రభావితం చేసే బగ్స్
 
మా చెల్లింపు ఉత్పత్తులను ప్రభావితం చేసే బగ్స్ ఎల్లప్పుడూ మా అత్యంత ప్రాధాన్యతగా ఉంటాయి. కొన్ని సందర్భాల్లో, మేము మమ్మల్ని నేరుగా ప్రభావితం చేసే బగ్‌లను మాత్రమే పరిష్కరిస్తాము.
 
### 2. కమ్యూనిటీ పుల్ రిక్వెస్టులు
 
మీరు బగ్‌ను గుర్తించి దానికి పరిష్కారం కనుగొంటే, దయచేసి పుల్ రిక్వెస్ట్‌ను సమర్పించండి. మా ఉత్పత్తులను ప్రభావితం చేసే సమస్యల తర్వాత, ఈ కమ్యూనిటీ ఆధారిత పరిష్కారాలకు మేము తదుపరి అత్యధిక ప్రాధాన్యత ఇస్తాము. సమీక్షించి ఆమోదించిన తర్వాత, మేము మీ పరిష్కారాన్ని విలీనం చేసి మీ సహకారానికి క్రెడిట్ ఇస్తాము.
 
### 3. ఆర్థిక మద్దతు
 
పైన పేర్కొన్న వర్గాల వెలుపల ఉన్న సమస్యల కోసం, మీరు వాటి పరిష్కారానికి నిధులు సమకూర్చుకోవచ్చు. ప్రతి ఓపెన్ ఇష్యూ ఆర్డర్ ఫారమ్‌కు లింక్ చేయబడింది, మీరు ఆర్థికంగా సహకరించవచ్చు. మేము అందించిన నిధి మొత్తాన్ని బట్టి ఈ సమస్యలకు ప్రాధాన్యత ఇస్తాము.
 
### కమ్యూనిటీ సహకారాలు
 
కమ్యూనిటీ చురుకుగా ఉన్నప్పుడు ఓపెన్ సోర్స్ వికసిస్తుంది. మీరు బగ్‌లను పరిష్కరించకపోయినా, కోడ్ మెరుగుదలలు, డాక్యుమెంటేషన్ నవీకరణలు, ట్యుటోరియల్స్ లేదా కమ్యూనిటీ ఛానెల్‌లలో ఇతరులకు సహాయం చేయడం ద్వారా సహకరించడానికి పరిగణించండి. ఓపెన్ సోర్స్ పనిని మద్దతు ఇవ్వడానికి మేము అందరినీ, కమ్యూనిటీగా, బలంగా ప్రోత్సహిస్తున్నాము.
 
_మళ్ళీ చెప్పాలంటే, DefectiveCode మా చెల్లింపు ఉత్పత్తులను, కమ్యూనిటీ పుల్ రిక్వెస్టులను మరియు సమస్యల కోసం అందుకున్న ఆర్థిక మద్దతును బట్టి బగ్‌లకు ప్రాధాన్యత ఇస్తుంది._

# లైసెన్స్ - MIT లైసెన్స్
 
కాపీరైట్ © డిఫెక్టివ్ కోడ్, LLC. అన్ని హక్కులు రిజర్వ్ చేయబడ్డాయి
 
ఈ సాఫ్ట్‌వేర్ మరియు సంబంధిత డాక్యుమెంటేషన్ ఫైళ్ల (సాఫ్ట్‌వేర్) యొక్క కాపీని పొందిన ఏ వ్యక్తికైనా, ఈ సాఫ్ట్‌వేర్‌ను పరిమితి లేకుండా ఉపయోగించడానికి, కాపీ చేయడానికి, సవరించడానికి, విలీనం చేయడానికి, ప్రచురించడానికి, పంపిణీ చేయడానికి, సబ్‌లైసెన్స్ ఇవ్వడానికి మరియు/లేదా సాఫ్ట్‌వేర్ కాపీలను అమ్మడానికి మరియు సాఫ్ట్‌వేర్ అందించబడిన వ్యక్తులను ఈ క్రింది షరతులకు లోబడి చేయడానికి అనుమతి ఉచితంగా ఇవ్వబడింది:
 
**పై కాపీరైట్ నోటీసు మరియు ఈ అనుమతి నోటీసు సాఫ్ట్‌వేర్ యొక్క అన్ని కాపీలలో లేదా ముఖ్యమైన భాగాలలో చేర్చబడాలి.**
 
సాఫ్ట్‌వేర్ "అలానే" అందించబడుతుంది, ఎటువంటి రకాల వారంటీ లేకుండా, వ్యక్తంగా లేదా సూచనాత్మకంగా, కానీ పరిమితం చేయకుండా, విక్రయయోగ్యత, నిర్దిష్ట ప్రయోజనానికి తగినదిగా మరియు ఉల్లంఘనకు సంబంధించిన వారంటీలను కూడా కలిగి ఉంటుంది. ఏదైనా సంఘటనలో రచయితలు లేదా కాపీరైట్ హోల్డర్లు ఏదైనా క్లెయిమ్, నష్టాలు లేదా ఇతర బాధ్యతకు బాధ్యులు కారు, ఒప్పందం, టార్ట్ లేదా వేరే విధంగా, సాఫ్ట్‌వేర్ నుండి లేదా సాఫ్ట్‌వేర్ ఉపయోగం లేదా ఇతర లావాదేవీలలో ఉత్పన్నమయ్యే.