English | العربية | বাংলা | Bosanski | Deutsch | Español | Français | हिन्दी | Italiano | 日本語 | 한국어 | मराठी | Português | Русский | Kiswahili | தமிழ் | తెలుగు | Türkçe | اردو | Tiếng Việt | 中文
- અપગ્રેડિંગ
- પરિચય
- સ્થાપના
- ઉપયોગ (લારેવેલ વિના)
- ઉપયોગ (લારેવેલ સાથે)
- રૂપરેખાંકન
- સપોર્ટ માર્ગદર્શિકા
- लायसन्स - MIT लायसन्स
અપગ્રેડિંગ
જો તમે અગાઉની આવૃતિમાંથી અપગ્રેડ કર રહ્યા છો, તો કૃપા કરીને અપગ્રેડ માર્ગદર્શિકા માટે તૂટી જાછે અને પ્રસંગાંત ગોઈને ચકાસો.
પરિચય
MJML એ એવા મર્કઅપ ભાષા છે જે ખાસ કરીને જવાબદારી ઈમેલ્સને કોડિંગની પ્રક્રિયાને સરળ બનાવાવવા માટે ડિઝાઇન કરવામાં આવી છે. તેની વૈવિધ્યપૂર્ણ સુત્રણા સરળતા અને સરળતાને સુનિશ્ચિત કરે છે, જ્યારે તેના વ્યાપક માનક ઘટકોની લાઇબ્રેરી વિકાસને ત્રિદ્રણ આપે છે અને તમારા ઈમેલ કોડબેઝની જટિલતામાં ઘટાડો કરે છે. MJML નો ખૂલ્લો સ્ત્રોત એન્જિન ઊંચી ગુણવત્તાની, જવાબદારી HTML જનરેટ કરે છે જે શ્રેષ્ઠ અમલમાં અનુપાલન કરે છે. જો તમે આઉટલુક સાથે કામ કરતી વખતે થતી કંટાળાનો અનુભવ કર્યો છે, તો આ પેકેજ તમારા માટે રચાયેલ છે.
આપણી MJML અમલ સત્તાવાર MJML API માટે એક પટ્ટા તરીકે કાર્ય કરે છે. હંમેશાં PHP માં સીધું HTML માં MJML એ સરળ હોસ્પિટેઝને પ્રવૃત્ત કરી રહ્યું છે, નોડજએસની જરૂર વગર. આ પેકેજ એ PHP એપ્લિકેશનો માટે આદર્શ છે જેનુ MJML નો સમાવેશ કરે છે પેકેજે નોડજએસ અને MJML CLI સ્થાપિત કરવાની ઝMig્જવટ વગર.
ઉદાહરણ
// લારેવેલ વિના(new MJML)->render( '<mjml><mj-body><mj-section><mj-column><mj-text>Hello World</mj-text></mj-column></mj-section></mj-body></mjml>'); // મિનિફાઇડ HTML(new MJML)->minify()->render( '<mjml><mj-body><mj-section><mj-column><mj-text>Hello World</mj-text></mj-column></mj-section></mj-body></mjml>'); // લારેવેલ સાથેMJML::render( '<mjml><mj-body><mj-section><mj-column><mj-text>Hello World</mj-text></mj-column></mj-section></mj-body></mjml>'); // લારેવેલ અને મિનિફાઇડ HTML સાથેMJML::minify()->render( '<mjml><mj-body><mj-section><mj-column><mj-text>Hello World</mj-text></mj-column></mj-section></mj-body></mjml>');
સ્થાપના
-
સૌ પ્રથમ, તમારા
composer.jsonફાઈલમાં નીચે દર્શાવેલા સૂચનાઓ તેને ઉમેરીને આ પેકેજને તમારા ઓપરેટિંગ સિસ્ટમ માટે યોગ્ય બાઇનરીઝ ખેંચવાનો આદેશ આપીને ઉમેરી શકો છો.install,update, અથવાdump-autoloadચલાવ્યા પછી બાઇનરીઝ ડાઉનલોડ થશે.{"post-autoload-dump": ["DefectiveCode\\MJML\\PullBinary::all"]}MJML બાઇનરી અમારી CDN થી પ્રાપ્ત થવાની અને આ પેકેજના "bin" ફોલ્ડરમાં સેવ થવાની છે કોમ્પોઝરનો સ્થાપન અથવા અપડેટ સમયે. ખાતરી કરે છે કે તમારી સ્થાનિક અને ઉત્પાદન વાતાવરણ માટે જરૂરી બાઇનરીઝ લોડ થાય છે.
ડિફોલ્ટે,
allઆ પેકેજ દ્વારા સપોર્ટ કરવામાં આવેલી બાઇનરીઝને ખેંચશે. અમે આને સક્ષમ કરવા, ઓપરેટિંગ અને આર્કિટેક્ચરના સિસ્ટમની અંદર ટેવા જાળવવા માટે ભલામણ કરીએ છીએ. નીચે આપેલ બાઇનરીઝ ઉપલબ્ધ છે.ઓપરેટિંગ સિસ્ટમ આર્કિટેક્ચર કોમ્પોઝર પોસ્ટ અપડેટ કમાન્ડ બધું બધું DefectiveCode\MJML\PullBinary::allડાર્ઇન (મેકઓએસ) arm64 DefectiveCode\MJML\PullBinary::darwin-arm64ડાર્ઇન (મેકઓએસ) x64 DefectiveCode\MJML\PullBinary::darwin-x64લિનક્સ (glibc) arm64 DefectiveCode\MJML\PullBinary::linux-arm64લિનક્સ (glibc) x64 DefectiveCode\MJML\PullBinary::linux-x64લિનક્સ (musl) arm64 DefectiveCode\MJML\PullBinary::linux-arm64-muslલિનક્સ (musl) x64 DefectiveCode\MJML\PullBinary::linux-x64-musl -
પછી, નીચે દર્શાવેલા કોમ્પોઝર કમાન્ડને ચલાવીને PHP પેકેજને સ્થાપિત કરો:
composer require defectivecode/mjml -
That's it! જો લારેવેલનો ઉપયોગ કરતા હોવ તો, આ પેકેજ લારેવેલના પેકેજ વપરાશ દ્વારા આપોઆપ સ્થાપિત થશે.
ઉપયોગ (લારેવેલ વિના)
જો તમે લારેવેલનો ઉપયોગ કરી રહ્યા છો તો કૃપા કરીને નીચે લારેવેલ સાથેના ઉપયોગને જુઓ.
MJML રેન્ડર કરતી વખતે
MJMLને રેન્ડર કરવા માટે, તમારું MJML સ્ટ્રિંગ render પદ્ધતિમાં મોકલો:
use DefectiveCode\MJML; $html = (new MJML)->render( '<mjml><mj-body><mj-section><mj-column><mj-text>Hello World</mj-text></mj-column></mj-section></mj-body></mjml>');
MJML માન્યતા
MJMLને માન્ય કરવા માટે, તમારું MJML સ્ટ્રિંગ isValid પદ્ધતિમાં મોકલો:
use DefectiveCode\MJML; $isValid = (new MJML)->isValid( '<mjml><mj-body><mj-section><mj-column><mj-text>Hello World</mj-text></mj-column></mj-section></mj-body></mjml>');
ઉપયોગ (લારેવેલ સાથે)
MJML રેન્ડર કરતી વખતે
MJMLને રેન્ડર કરવા માટે, MJML ફેસેડ પર render ની પદ્ધતિમાં તમારું MJML સ્ટ્રિંગ મોકલો:
use DefectiveCode\MJML\Facades\MJML; $html = MJML::render( '<mjml><mj-body><mj-section><mj-column><mj-text>Hello World</mj-text></mj-column></mj-section></mj-body></mjml>');
MJML માન્યતા
MJMLને માન્ય કરવા માટે, MJML ફેસેડ પર isValid પદ્ધતિમાં તમારું MJML સ્ટ્રિંગ મોકલો:
use DefectiveCode\MJML\Facades\MJML; $isValid = MJML::isValid( '<mjml><mj-body><mj-section><mj-column><mj-text>Hello World</mj-text></mj-column></mj-section></mj-body></mjml>');
રૂપરેખાંકન
તમને નીચે દર્શાવેલા કમાન્ડનો ઉપયોગ કરીને રૂપરેખાંકન ફાઇલ પ્રકાશિત કરી શકો છો:
php artisan vendor:publish --provider="DefectiveCode\MJML\MJMLServiceProvider"
આ તમારા config ફોલ્ડરમાં mjml.php રૂપરેખાંકન ફાઇલો બનાવશે. રૂપરેખાંકન ફાઇલમાં સત્તાવાર MJML ફેસેડનો ઉપયોગ કરતી વખતે ટ્રાન્સફર કરવામાં આવેલા બધા વિકલ્પો config ઑબ્જેક્ટમાં પૂર્વભવિત છે.
રૂપરેખાંકન
બધા રૂપરેખાંકન વિકલ્પો MJML ઓબ્જેક્ટ પર સીધા આ રીતે નિર્ધારિત કરી શકાય છે.
use DefectiveCode\MJML; $html = (new MJML) ->setMinify(true) ->setBeautify(false) ->render( '<mjml><mj-body><mj-section><mj-column><mj-text>Hello World</mj-text></mj-column></mj-section></mj-body></mjml>' );
આપણી પેકેજ સત્તાવાર MJML પેકેજ જેવી જ રૂપરેખાંકનનું પાલન કરે છે ઉલ્લેખિત નીચેના જ હોય છે:
પ્રિપ્રોસેસર્સ- આ વિકલ્પ ઉપલબ્ધ નથી. જો તમે આ વિકલ્પ ઉમેરવા માંગતા હોવ, તો કૃપા કરીને એક પુલ વિનંતી ખોલો.minifyOptions- અમે આઉટપુટ સુસંગતતાના લાયકાત માટે PHP માં મિનિફીકેશન રાખીએ છીએ. મિનિફાયર ટિપ્પણીઓ દૂર કરે છે (આઉટલુક કન્ડિશનલ્સને છોડી દેવું),.WHITE SPACEનું સમીકરણ કરે છે, અને ટેગ્સ વચ્ચેની WHITE SPACE દૂર કરે છે.sanitizeStyles,templateSyntax, અનેallowMixedSyntax- આ MJML 5 વિકલ્પો MJML ના સ્થાનિક htmlnano/cssnano મિનિફિકેશન માર્ગને લાગુ પડે છે. આ પેકેજના PHP મિનિફાયર દ્વારા ઉપયોગમાં લેવાતા નથી.
ફોન્ટ્સ
આપણો પેકેજ નમ્રતા અને નિવૃત્તમાં સ્થાયા પાસેથી અનુગામી ફોન્ટને ડિફોલ્ટ તરીકે ઉપયોગ કરે છે.
- ઓપન સિંસ: 'https://fonts.googleapis.com/css?family=Open+Sans:300,400,500,700
- ડ્રોઇડ સિંસ: 'https://fonts.googleapis.com/css?family=Droid+Sans:300,400,500,700
- લેટો: https://fonts.googleapis.com/css?family=Lato:300,400,500,700
- રોબોટો: https://fonts.googleapis.com/css?family=Roboto:300,400,500,700
- ઉબન્ટુ: https://fonts.googleapis.com/css?family=Ubuntu:300,400,500,700
તમે નીચેની પદ્ધતિઓનો ઉપયોગ કરીને ફોન્ટને બદલી શકો છો:
addFont(string $font, string $url)- ફોન્ટને ફોન્ટોની યાદીમાં ઉમેરો.removeFont(string $font)- ફોન્ટોને યાદીમાંથી દૂર કરો.setFonts(array $fonts)- ફોન્ટોની યાદી સેટ કરો. તમે આ ફોર્મેટમાં ફોન્ટોના અર્રેમાં પ્રદાન કરવું જોઈએ:['ફોન્ટ-ના' => 'ફોન્ટ-url'].
ટિપ્પણો
ટિપ્પણો ડિફોલ્ટે જાળવવામાં આવે છે. જો તમે ટિપ્પણોને દૂર કરવા માંગતા હો, તો તમે removeComments() પદ્ધતિનો ઉપયોગ કરી શકો છો.
તમે removeComments()ને કૉલ કરીને keepComments() મોટે ભાગે ખસાવી શકો છો.
સમાવેશ અવગણવું
ડિફોલ્ટે, આપણો પેકેજ mj-include ટૅગને અવગણતા છે. આ MJML 5 の વધુ સુરક્ષિત ડિફોલ્ટને મેળવે છે. તમે ignoreIncludes(false) કૉલ કરીને સમાવેશને সক্ষম કરી શકો છો.
સમાવેશને સક્ષમ કરવા વખતે, filePath(string $path) ને મૌલિક ડાયરેક્શન તરીકે અને includePath(string|array|null $path) નો ઉપયોગ કરીને વધુ સમાવેશ ડાયરેક્શનને મંજૂર કરવા માટે કામ કરવું.
સુંદર બનાવવું
અમારો પેકેજ js-beautify નો ઉપયોગ કરીને HTMLને સુંદર બનાવશે. MJML 5.2 પણ આંતરિક રીતે js-beautify નો ઉપયોગ કરે છે, પરંતુ આ પેકેજ કસ્ટમ PHP beautifyOptions ની સાથોસાથ સુખદ બનાવટને જાળવે છે. ડિફોલ્ટ વિકલ્પો છે:
- indentSize: 2
- wrapAttributesIndentSize: 2
- maxPreserveNewline: 0
- preserveNewlines: false
જયારે
js-beautifyવિકલ્પો પ્રદાન કરવા માટે snake_case નો ઉપયોગ કરે છે, ત્યારે તમે અમારા પેકેજનો ઉપયોગ કરતી વખતે camelCase નો ઉપયોગ કરવો જોઈએ. આ જાળવા માટે અમે આ પસંદગી કરી છે અમારા પેકેજને રૂપરેખાંકન વિકલ્પોના અન્ય હિસ્સાના સાથોસાથ સુરક્ષિત રાખશે. અમારો પેકેજ આપોઆપ ઉપરાંત પાસાયવ આ કૅમલકેઝના વિકલ્પોને snake_case તરીકે ફેરવશે.
તમે નીચે દર્શાવેલા પદ્ધતિઓનો ઉપયોગ કરીને માન્ય js-beautify રૂપરેખાંકન પ્રદાન કરીને આ વિકલ્પોમાંથી કોઈપણને મીટાવી શકો છો:
setBeautifyOptions(array $options)-js-beautifyવિકલ્પો સેટ કરો.addBeautifyOption(string $option, mixed $value)-js-beautifyવિકલ્પ ઉમેરે છે.removeBeautifyOption(string $option)-js-beautifyવિકલ્પ દૂર કરે છે.
મિનિફાઈ
અમારો પેકેજ(enabled) માં HTML આઉટપુટને મિનિફાઈ કરશે. મિનિફિકેશન નીચેની કરે છે:
- HTML ટિપ્પણોને દૂર કરે છે (આઉટલુકની શરતી ટિપ્પણાઓ જેમ કે
<!--[if mso]>ને જાળવી રાખે છે) - બહુધા WHITE SPACE અક્ષરોને એક યુનિષ્ટ જગ્યા માટે ઘટાડે છે
- HTML ટેગ્સની વચ્ચે WHITE SPACE દૂર કરે છે
તમે minify(bool $minify) પદ્ધતિને કૉલ કરીને મિનિફિકેશનને સક્ષમ અથવા ઘટાડવામાં લઇ શકો છો.
શું PHP આધારિત મિનિફિકેશન? MJML 5 હવે જૂની સુરક્ષિત
html-minifierપેકેજનો ઉપયોગ કરતી નથી. આ પેકેજ હજી પ્રવૃત્તિના વર્તમાન વર્ઝન 2.x માં સ્થાપિત કરવામાં આવેલ છે. જો તમને MJML 5 ના સ્થાનિક htmlnano/cssnano મિનિફિકેશન વિકલ્પોની જરૂર હોય, તો જરૂરી વિકલ્પ લાયકતાના ચિહ્ન સાથે એક ઇશ્યુ ખોલો.
માન્યતા સ્તર
અમારો પેકેજ સ્વભાવિક માન્યતા સ્તર તરીકે soft માં MJML ને માન્ય કરશે. તમે validationLevel(ValidationLevel $validationLevel) પદ્ધતિનો ઉપયોગ કરીને આને બદલી શકો છો. ડિપ્રેશન ક્ષેપ સ્ટેપ સમ ઉકેલો:
strict- તમારી ડોક્યુમેન્ટ માન્યતાની પ્રક્રિયાથી પસાર થાય છે અને તેમાં કોઈપણ ભૂલ હોવાનું મામલો નથી.soft- તમારી ડોક્યુમેન્ટ માન્યતાની પ્રવૃત્તિમાંથી પસાર થાય છે અને જો તેમાં ભૂલ હોય તો તેને રેન્ડર કરવામાં આવશે.skip- તમારી ડોક્યુમેન્ટ માન્યતાથી પસાર થાય છે વિના સાધનની પ્રક્રિયાની આધારશુન્ય વિનંતીઓ અભ્યાસ કરવા પર રેન્ડર થતી રહેશે.
ફાઇલ પાથ
અમારો પેકેજ ડિફોલ્ટ તરીકે . ડાયરેકટરીનો ઉપયોગ કરશે. તમે filePath(string $path) પદ્ધતિને કૉલ કરીને આ બદલી શકો છો.
MJML 5 એ filePath ને સમાવેદન સમકક્ષ તરીકે માન્ય રાખે છે. જો સમાવેશ સક્ષમ છે, તો filePath ના બાહ્ય પાથોને દૂર કરવામાં આવશે જો તેઓ સ્પષ્ટપણે મંજૂર કરવામાં આવી નથી includePath(string|array|null $path).
જ્યુસ
અમે મૂળભૂત રીતે આપણી પાસે કોઈ પણ જ્યૂસ વિકલ્પો પ્રદાન કરતા નથી. તમે નીચે મુજબની પદ્ધતિઓનો ઉપયોગ કરીને જ્યૂસ વિકલ્પો ઉમેરી શકો છો:
setJuiceOptions(array $options)- જ્યૂસ વિકલ્પો સેટ કરો.addJuiceOption(string $option, mixed $value)- જ્યૂસ વિકલ્પ ઉમેરે છે.removeJuiceOption(string $option)- જ્યૂસ વિકલ્પ દૂર કરે છે.setJuicePreserveTags(array $tags)- જ્યૂસ સંરક્ષણ ટેગ સેટ કરો.addJuicePreserveTag(string $tag, mixed $value)- જ્યૂસ સંરક્ષણ ટેગ ઉમેરે છે.removeJuicePreserveTag(string $tag)- જ્યૂસ સંરક્ષણ ટેગ દૂર કરે છે.
સપોર્ટ માર્ગદર્શિકા
આપણી ઓપન સોર્સ પેકેજ પસંદ કરવા માટે તમારો આભાર! કૃપા કરીને આ સેટેલાઈટ માર્ગદર્શિકાઓને ચકાસવા માટે થોડી મિનિટો પસાર કરો. આ પગલાં તમે અમારી યોજના પરથી વધુ સારી રીતે ઉપયોગી થવામાં મદદ કરશે.
સમુદાય ચલિત સહાયતા
અમારી ઓપન-સોર્સ યોજના અમારી શાનદાર સમુદાય દ્વારા ચલાવવામાં આવે છે. જો તમારી પાસે પ્રશ્નો છે અથવા સહાયતા જરૂર છે, તો સ્ટેકઓવરફ્લો અને અન્ય ઓનલાઈન સાધનો તમારા શ્રેષ્ઠ વિકલ્પ છે.
બગ્સ અને ફીચર પ્રાયોરિટાઈઝેશન
એક ઓપન-સોર્સ યોજના સંચાલિત કરવાનો વાસ્તવિકતાનો અર્થ એ છે કે દરેક નોંધાયેલા બગ અથવા ફીચર વિનંતી તરત ઠીક કરી શકતા નથી. અમે મુદ્દાઓને નીચેના ક્રમમાં પ્રાથમિકતા આપીએ છીએ:
1. અમારા પેઇડ ઉત્પાદનોને અસર કરતી બગ્સ
આપણાં પેઇડ ઉત્પાદનોને અસર કરતી બગ્સ હંમેશા અમારી ટોચની પ્રાથમિકતા રહેશે. કેટલીકવાર, અમે ફક્ત તે બગ્સને addressed કરીશું જે અમારો સીધો અસર કરે છે.
2. સમુદાય પુલ વિનંતીઓ
જો તમે એક બગ ઓળખી લીધો છે અને ત્યાં એક ઉકેલ છે, તો કૃપા કરીને પુલ વિનંતિ રજૂ કરો. અમારી ઉત્પાદનોને અસર કરતી મુદ્દા પછી, અમે આ સમુદાય ચલિત ઉકેલો માટે આગામી ઉંચી પ્રાથમિકતા પ્રદાન કરીએ છીએ. એક વાર સમીક્ષા અને મંજૂરી મેળવ્યા પછી, અમે તમારા ઉકેલને ઉમેરશું અને તમારી મુસદ્દાને માન આપશું.
3. નાણાની સહાયતા
ઉલ્લેખિત શ્રેણીઓની બહારના મુદ્દાઓ માટે, તમે તેમના સમાધાન માટે નાણાની સહાયતા આપવા માટે પસંદ કરી શકો છો. મોટી સમસ્યાઓ દરખાસ્તના ફોર્મ સાથે જોડાયેલી છે જયાં તમે નાણાંકીય રીતે ઇનામ આપી શકો છો. અમે આ મુદ્દાઓને આપવામાં આવેલા નાણાંની રકમના આધારે પ્રાથમિકતા આપીએ છીએ.
સમુદાયના યોગદાન
ઓપન સોર્સ ત્યારે જ જીવંત રહે છે જ્યારે તેની સમુદાય સક્રિય છે. જો તમે બગ્સને ઠીક નથી કરી રહ્યાં, તો કોડના સુધારા, દસ્તાવેજી અપડેટ, ટ્યુટોરિયલ્સ માધ્યમથી યોગદાન આપવાની ચૂકવણી કરો અથવા સમુદાય ચેનલોમાં અન્ય લોકોને મદદ કરે. અમે દરેકને બળાતમ ઉમેદવારી આપવાની ઉદ્બનકતામાં મદદરૃષ માટે ઉત્સાહિત કરીએ છીએ.
ફરીથી પુનરાવર્તન કરીએ, DefectiveCode બગ્સને અમારી પેઇડ ઉત્પાદનો પર કેવી રીતે અસર કરે છે તેના આધારે પ્રાથમિકતા આપશે, સમુદાય પુલ વિનંતીઓને, અને મુદ્દાઓ માટે મળેલ નાણાંકીય સહાયતા.
लायसन्स - MIT लायसन्स
कॉपीराइट © Defective Code, LLC. सर्व हक्क राखीव आहेत
या संगणक प्रोग्रामचा आणि संबंधित दस्तऐवज फाइल्स (या "सॉफ्टवेअर" म्हणून) एक प्रती मिळवणाऱ्या कोणत्याही व्यक्तीला, निर्बंधाशिवाय सॉफ्टवेअरमध्ये व्यवहार करण्याची परवानगी दिली जाते, ज्यात वापरण्याच्या, कॉपी करण्याच्या, सुधारित करण्याच्या, विलीन करण्याच्या, प्रकाशित करण्याच्या, वितरणाच्या, उपलायन करण्याच्या, आणि/किंवा सॉफ्टवेअरच्या प्रतींची विक्री करण्याच्या अधिकारांचा समावेश आहे, आणि ज्यांना सॉफ्टवेअर दिला जातो त्यांना असे करण्याची परवानगी देणे, खालील अटींच्या अधिन जातात:
वर उल्लेखित कॉपीराइट नोटिस आणि ही परवानगी नोटिस सर्व प्रतींमध्ये किंवा सॉफ्टवेअरच्या महत्त्वाच्या भागांमध्ये समाविष्ट केली जावी.
सॉफ्टवेअर "जसे आहे" दिले जाते, कोणत्याही प्रकारच्या वॉरन्टीशिवाय, स्पष्ट किंवा अप्रत्यक्ष, विक्रीसाठी तयार असणे, विशेष उद्देशासाठी योग्य असणे आणि कॉपीराइटचा भंग न करणारे यांचा समावेश, पण यापर्यंत सीमित नाही. लेखक किंवा कॉपीराइट धारक कोणत्याही दाव्यांसाठी, नुकसानांसाठी किंवा इतर जबाबदाऱ्याासाठी उत्तरदायी नाहीत, हे कॉन्ट्रॅक्ट, टॉर्ट किंवा इतर कोणत्याही प्रकारात असो, सॉफ्टवेअरशी संबंधित किंवा सॉफ्टवेअरसह किंवा इतर व्यवहारासंबंधी येणारे.