వికీపీడియా:గాడ్జెట్

/*  _____________________________________________________________________________
 * |                                                                             |
 * |                    === WARNING: GLOBAL GADGET FILE ===                      |
 * |                  Changes to this page affect many users.                    |
 * | Please discuss changes on the talk page or on [[WT:Gadget]] before editing. |
 * |_____________________________________________________________________________|
 * 
 * Imported from version XXXX as of DATE from [[SCRIPT_SOURCE]]
 * SHORT_DESCRIPTION, see [[SCRIPT_HOME_PAGE]]
 */

ఇదొక సమాచారం పేజీ.

ఇది వికీపీడియా విధానం గానీ, మార్గదర్శకం గానీ కాదు. ఇది వికీపీడియా సంప్రదాయాలు, కట్టుబాట్లు, సాంకేతికాంశాలు, అవలంబించే పద్ధతులకు సంబంధించిన కొన్ని విషయాలను వివరిస్తుంది.. ఇందులో ఏకాభిప్రాయం, అర్థ స్వీకరణ లలో విభిన్న స్థాయిలు ఉండవచ్చు.

Shortcuts

వికీపీడియా గాడ్జెట్ అనేది మీ ప్రాధాన్యతలలోని ఒక ఎంపికను తనిఖీ చేయడం ద్వారా ప్రారంభించగల జావాస్క్రిప్ట్ ప్రోగ్రామ్/లేదా CSS స్నిప్పెట్. గాడ్జెట్ ఫంక్షన్ మీడియావికీ పొడిగింపు గాడ్జెట్‌ల ద్వారా అందించబడింది.

అనేక గాడ్జెట్లు యూజర్ స్క్రిప్ట్లుతోనే ప్రారంభమయ్యాయి. వినియోగదారు లిపిని గాడ్జెట్‌గా ఆమోదించిన తర్వాత, అది వికీపీడియాః వాడుకరి లిపి/జాబితా నుండి తొలగించబడింది. ప్రస్తుతం ఇన్‌స్టాల్ చేయబడిన గాడ్జెట్లు స్పెషల్ః గాడ్జెట్లలో జాబితా చేయబడతాయి.

గాడ్జెట్లు కోసం సాధారణ ప్రమాణాలు

వికీపీడియాలో అమలు చేయడానికి, గాడ్జెట్లు సాధారణంగా ఈ క్రింది షరతులను దాటాలిః

తదుపరి ఆకృతీకరణ లేకుండా చేర్చినట్లయితే గాడ్జెట్లు తప్పక పనిచేయాలి. వాటిని వ్యక్తిగత common.js ద్వారా ఆకృతీకరించవచ్చు, కానీ అవి ఆకృతీకరించబడకుండ పనిచేయాలి.
గాడ్జెట్లు అన్ని ప్రధాన బ్రౌజర్లతో అనుకూలంగా ఉండాలి, అంటే అవి లోపాలతో ముగించకూడదు.
చాలా ప్రధాన బ్రౌజర్లలో గాడ్జెట్లు పనిచేస్తూ ఉండాలి (క్రాస్-బ్రౌజర్ అనుకూలత). మినహాయింపులు స్పష్టంగా పేర్కొనబడాలి.
గాడ్జెట్ల నకలు సహేతుకమైనట్లయితే మాత్రమే తయారు చేయాలి.
స్క్రిప్ట్ల సేకరణలు విభిన్న విధులను కలిగి ఉంటే వాటిని విభజించాలి.
అనుమతులు అవసరమయ్యే గాడ్జెట్లు గుర్తించబడాలి, అనుమతులు లేకపోతే మనోహరంగా విఫలమవ్వాలి.
కొన్ని శరీర నిర్మాణాలలో మాత్రమే పనిచేసే గాడ్జెట్లు ఆ డేటా అందుబాటులో ఉంటే గుర్తించబడాలి.

డిఫాల్ట్‌గా గుర్తించబడిన, పెద్ద వినియోగదారుల సమూహాల కోసం లోడ్ చేయబడిన గాడ్జెట్లు వారు కట్టుబడి ఉండాల్సిన అదనపు ప్రమాణాలను కలిగి ఉంటాయి.

ప్రతిపాదనలు

కొత్త గాడ్జెట్లను ప్రవేశపెట్టటానికి రచ్చబండలోని సాంకేతిక విభాగంలో ప్రతిపాదించాలి. చారిత్రాత్మకంగా,ఈ పేజీ ఉప పేజీ కొత్త గాడ్జెట్లు ప్రతిపాదించబడ్డాయి,కానీ తక్కువ భాగస్వామ్యం కారణంగా ఆ పేజీ చారిత్రాత్మకంగా గుర్తించబడింది.అలాగే,ఇప్పటికే ఉన్న వికీ ప్రాజెక్ట్ యూజర్ స్క్రిప్ట్లను గాడ్జెట్లుగా మార్చడానికి మూల్యాంకనం చేసేవారు,కానీ ఆ ప్రక్రియ కూడా చారిత్రాత్మకంగా గుర్తించబడింది.

సంస్థాపన

రచ్చబండలోని సాంకేతిక విభాగంలో చర్చించిన తరువాత, ఇంటర్ఫేస్ నిర్వాహకులు ఈ క్రింది విధంగా గాడ్జెట్లను వ్యవస్థాపించవచ్చుః

మీడీయావికీః Gadget-scriptname.js కు దిగువ శీర్షిక, స్క్రిప్ట్ కోడ్‌ను జోడించండి
ఐచ్ఛికంగా, దిగువ శీర్షికను, CSS కోడ్ను MediaWiki: Gadget-scriptname.css కు జోడించండి.
మీడియావికీః గాడ్జెట్-స్క్రిప్ట్ పేరుకు స్క్రిప్ట్ వివరణను జోడించండి. అవసరమైతే స్క్రిప్ట్ హోమ్/లేదా హెల్ప్ పేజీ, స్టేట్ బ్రౌజర్ అవసరాలకు లింక్ చేయండి.
తగిన శీర్షిక కింద MediaWiki: గాడ్జెట్స్-నిర్వచనానికి జోడించండి * స్క్రిప్ట్ పేరు | scriptname.js [| scriptname.css | otherscript.js |...]
```
 * scriptname|scriptname.js[|scriptname.css|otherscript.js|...]
```

ఈ గాడ్జెట్ ఇప్పుడు స్పెషల్ః గాడ్జెట్లలో కనిపించాలి.

కామెంట్లు

గాడ్జెట్ వివరణ టెంప్లేట్లకు వ్యాఖ్యలు లేదా హెచ్చరికలను రెండు విధాలుగా జోడించవచ్చుః

నోయిన్క్యూడ్ ట్యాగ్ (వివరణ పేజీలో లింకులతో కనిపిస్తుందిః <నోయిన్కూడ్> కామెంట్ <noinclude> comment </noinclude>
HTML వ్యాఖ్యలు (మూల పాఠంలో మాత్రమే కనిపిస్తాయి): <! --కామెంట్-->-- comment -->

శీర్షిక

ఈ క్రింది శీర్షికను గాడ్జెట్ ఫైళ్ళకు జోడించాలిః

/*  _____________________________________________________________________________
 * |                                                                             |
 * |                    === WARNING: GLOBAL GADGET FILE ===                      |
 * |                  Changes to this page affect many users.                    |
 * | Please discuss changes on the talk page or on [[WT:Gadget]] before editing. |
 * |_____________________________________________________________________________|
 * 
 * Imported from version XXXX as of DATE from [[SCRIPT_SOURCE]]
 * SHORT_DESCRIPTION, see [[SCRIPT_HOME_PAGE]]
 */

అప్రమేయ గాడ్జెట్లు

వికీపీడియా సందర్శకులందరికీ డిఫాల్ట్ కీవర్డ్ ఉన్న గాడ్జెట్ ప్రారంభించబడుతుంది. రిజిస్టర్డ్ వినియోగదారులు మాత్రమే దానిని నిలిపివేయవచ్చు. [default|rights = minoredit] వివరణతో ఉన్న గాడ్జెట్ స్వయంచాలకంగా రిజిస్టర్డ్ వినియోగదారులకు మాత్రమే పనిచేస్తుంది. ప్రమాణాలు వినియోగదారులందరికీ డిఫాల్టుగా ఎనేబుల్ చేయబడిన గాడ్జెట్లు కఠినమైన నియమాలకు అనుగుణంగా ఉండాలి. ఇవి తప్పనిసరిగా అన్ని డిఫాల్ట్ షిప్పింగ్ కోడ్లకు వర్తించే అదే నియమాలు. ఎందుకంటే వినియోగదారులకు వాటిని ప్రారంభించడంలో క్రియాశీల ఎంపిక లేదు. గాడ్జెట్లు మొత్తం వెబ్సైట్ పనితీరు, భద్రత, స్థిరత్వాన్ని ప్రభావితం చేసేవిధంగా ఈ గాడ్జెట్లు ఉండాలిః

అనుభవజ్ఞుడైన జావాస్క్రిప్ట్ డెవలపర్ (సాధారణంగా ఒక ఇంటర్ఫేస్ అడ్మిన్) సమీక్షించారు.
"బాగా నిర్వహించండి".
మూడవ పార్టీ వనరుల విధానానికి అనుగుణంగా.
సమర్థవంతంగా అమలు చేయడానికి వ్రాయండి, అంటే అవసరమైనంత తక్కువ కోడ్తో. గాడ్జెట్ యొక్క పూర్తి కార్యాచరణకు చాలా జావాస్క్రిప్ట్ కోడ్ అవసరమైతే, ఈ కోడ్ షరతులతో, సోమరితనం, లేదా డిమాండ్ మీద మాత్రమే లోడ్ చేయాలి (లోడ్ చేయడానికి క్లిక్ చేయండి.
అందుచేత ప్రాప్యత సమస్యలు లేవు.
శైలులు-మాత్రమే గాడ్జెట్లు మినహా, కంటెంట్ చదవగలిగేలా ఉండవలసిన అవసరం లేదు.
ముద్రణ పేజీలలో జోక్యం చేసుకోకండి.
ప్రస్తుత భద్రతా, గోప్యతా ప్రమాణాలకు అనుగుణంగా ఉండండి.

ఈ జాబితాను సమగ్రమైనదిగా పరిగణించకూడదు.

టెంప్లేట్ గాడ్జెట్లు

టెంప్లేట్ గాడ్జెట్లు డిఫాల్ట్ గాడ్జెట్ల ప్రత్యేక వర్గం. ఈ గాడ్జెట్లు స్పష్టమైన ట్రిగ్గర్ వర్గాలలో ఉన్న పేజీలలో మాత్రమే నడుస్తాయి, సాధారణంగా ఒక పేజీకి ఒక టెంప్లేటును జోడించడం ద్వారా నియంత్రించబడతాయి. ట్రిగ్గర్ వర్గాలు నిర్వచనంతో అనుసంధానించబడినందున అవి కదలిక-రక్షణలో ఉండాలి.

ప్రస్తుతం వ్యవస్థాపించబడిన పరికరాలు

వినియోగదారులు తమ ప్రాధాన్యతల పేజీలోని గాడ్జెట్ల విభాగంలో అందుబాటులో ఉన్న అన్ని గాడ్జెట్లను బ్రౌజ్ చేయవచ్చుః

Preferences → Gadgets

అన్ని క్రియాశీల గాడ్జెట్లు, వాటి స్క్రిప్ట్ ఫైళ్ళకు లింకుల జాబితా కోసం స్పెషల్ః గాడ్జెట్లను చూడండి.

వినియోగదారు స్క్రిప్ట్ను గాడ్జెటుగా మార్చడం వల్ల కలిగే లాభనష్టాలు

లాభాలు

స్క్రిప్ట్ను స్పెషల్ః ప్రిఫరెన్స్లకు జోడిస్తుంది, ఇది ఇన్స్టాల్ చేయడాన్ని చాలా సులభం చేస్తుంది.
స్క్రిప్ట్ను స్పెషల్ః ప్రిఫరెన్సెస్కు జోడిస్తుంది, ఇది స్క్రిప్ట్ను మార్కెటింగ్ చేయడంలో సహాయపడుతుంది, కాలక్రమేణా ఇన్స్టాల్ గణనలను పెంచుతుంది.
వినియోగదారు స్క్రిప్టును కమ్యూనిటీకి ఇస్తుంది, ఇంటర్ఫేస్ నిర్వాహకులు ఇతర వినియోగదారుల నుండి సవరణ అభ్యర్థనలను మంజూరు చేసే అవకాశం ఉంది, నిర్వాహకుడు క్రియారహితంగా ఉంటే వినియోగదారు స్క్రిప్ట్ను ఫోర్క్ చేయవలసిన అవసరాన్ని తగ్గిస్తుంది.
దీన్ని "డిఫాల్ట్ గాడ్జెట్" గా గుర్తించే సామర్థ్యం, ఇది అందరికీ లోడ్ అవుతుంది.
రిసోర్స్లోడర్ మాడ్యూల్స్, CSS స్క్రిప్ట్ పేజీ లోడ్ మీద ఆధారపడి ఉంటుంది, ఇది స్క్రిప్ట్ వేగంగా సిద్ధంగా ఉండటానికి అనుమతిస్తుంది.

ముఖ్యంగా వినియోగదారు స్క్రిప్ట్లో చాలా మంది వినియోగదారులు ఉన్నప్పుడు...

గాడ్జెట్లు ఇతర గాడ్జెట్లతో మినిఫికేషన్, బండ్లింగ్ను అందిస్తాయి, ఇది ఫైల్ పరిమాణాలు, HTTP ట్రాఫిక్ను తగ్గిస్తుంది.
హ్యాకింగ్ నుండి సాధ్యమైన రక్షణ. ఇంటర్ఫేస్ నిర్వాహకులందరికీ రెండు కారకాల ప్రామాణీకరణ ఉంటుంది, అవి క్రియారహితంగా మారితే తొలగించబడతాయి. ఒక సాధారణ నిర్వాహకుడు క్రియారహితంగా ఉండి, తరువాత వారి ఖాతా రాజీపడవచ్చు.
రోగ్ యూజర్ స్క్రిప్ట్ డెవలపర్ నుండి సాధ్యమైన రక్షణ. ఇంటర్ఫేస్ నిర్వాహకులు RFA ద్వారా వెళ్ళారు, వారు రోగ్ అయ్యే అవకాశం తక్కువ.

ప్రతికూలతలు

ES7 వరకు మాత్రమే జావాస్క్రిప్ట్ ఫీచర్‌లను ఉపయోగించడానికి అనుమతిస్తుంది. అసింక్-అవైట్ వంటి కొన్ని ES8 ఫీచర్‌లను requiresES6 ఫ్లాగ్‌తో ఉపయోగించవచ్చు. మెయింటెయినర్ ఇంటర్‌ఫేస్ అడ్మినిస్ట్రేటర్ కాకపోతే, వారు ఇప్పుడు ఏవైనా కోడ్ మార్పులు చేయడానికి మూస:Edit interface-protected అభ్యర్థనలను చేయవలసి ఉంటుంది, ఇది అభివృద్ధిని నెమ్మదిస్తుంది. చాలా దశలు. మెయింటెయినర్ దానితో సరేనని నిర్ధారించుకోవాలి, WP:VPT వద్ద ఏకాభిప్రాయం పొందాలి, ఆపై ప్రతిదీ సెటప్ చేయడానికి ఇంటర్‌ఫేస్ అడ్మినిస్ట్రేటర్‌ను పొందాలి. ప్రతి ఒక్కరినీ పాత యూజర్ స్క్రిప్ట్ నుండి గాడ్జెట్‌కి మార్చడానికి ఒక ప్రణాళిక అవసరం కావచ్చు. బగ్‌ల గురించి ఏదైనా ఆందోళన ఉంటే, అస్థిరమైన రోల్‌అవుట్ చేయవలసి రావచ్చు.

ఇవి కూడా చూడండి

MediaWiki చర్చః గాడ్జెట్లు-నిర్వచనం, గాడ్జెట్ల తయారీ, నిర్వహణ సాంకేతిక వివరాలను చర్చించడం
స్పెషల్ః గాడ్జెట్ యూసేజ్, గాడ్జెట్ వినియోగంపై గణాంకాలను అందిస్తుంది
mw:Extension: గాడ్జెట్స్, గాడ్జెట్ పొడిగింపు కొరకు మీడియావికీ డాక్యుమెంటేషన్
టెంప్లేట్ః బగ్ రిపోర్ట్, వివరణాత్మక బగ్-సంబంధిత సమాచారం కోసం టెంప్లేటు సందేశం
mw: గాడ్జెట్ కిచెన్, గాడ్జెట్లు రాయడం గురించిన ట్యుటోరియల్
వికీపీడియాః గాడ్జెట్/రిపోజిటరీస్, గాడ్జెట్లు, యూజర్ స్క్రిప్ట్ల కోసం వెర్షన్ కంట్రోల్ రిపోజిటరీల జాబితా