Defective Code Logo

Total Downloads Latest Stable Version Latest Stable Version

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

மேம்படுத்தும் வேலை

முந்தைய பதிப்பிலிருந்து மேம்படுத்துகிறீர்கள் என்றால், மேம்படுத்தும் வழிகாட்டி யைப் பார்க்கவும், முற்றுப்புள்ளிகள் மற்றும் மாறுதலுக்கான படிகளைப் பார்க்கவும்.

அறிமுகம்

MJML என்பது மின்னஞ்சல் தொடர்பான குறியீட்டை உருவாக்கும் செயல்முறையை எளிதாக்குவதற்காக வடிவமைக்கப்பட்ட markup மொழி ஆகும். இதன் அர்த்தமுள்ளரீதியமைப்பு எளிமையாகவும் மற்றும் எளிதாகவும் உறுதி செய்கிறது, இதன் பரந்த அளவிலான தரமான கூறுகளின் ஆன்லைன் அட்டவணை உருவாக்கத்திற்கு வேகம் கொடுக்கிறது மற்றும் மின்னஞ்சல் குறியீட்டுப் பிளவுகளை குறைக்கிறது. MJML இன் திறந்த மூல இயந்திரம் உயர் தரமான, பதிலளிக்கும் HTML ஐ உருவாக்குகிறது, இது சிறந்த நடைமுறைகளுக்கு அடைவதாகும். ஆவணங்களைத் தொல்லை படுத்தினால், இந்த தொகுப்பு நீங்கள் தேடிக்கொண்டிருக்கும் உத்தியாக்கத்தில் உள்ளது.

எமது MJML நடைமுறை அதிகாரப்பூர்வ MJML API க்கு அட்டி அணிகனமாக இருக்கிறது. இது PHP இல் நேரடியாக MJML ஐ HTML க்கு சாண்டத்தில் மூலம் எளிதான சுருக்கங்களை இடுங்குகிறது, NodeJS இன் தேவையின்றி. இந்த தொகுப்புக் கட்டமைப்பு அடிப்படையிலான घटकங்களை அடிப்படையாகக் கொண்ட PHP செயலிகளுக்குப் பொருந்துகிறது, NodeJS மற்றும் MJML CLI ஐ நிறுத்தும் சிரமம் இல்லாமல்.

எடுத்துக்காட்டு

// லாரவெல் இல்லாமல்
(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>'
);

நிறுவுதல்

  1. முதலில் உங்கள் composer.json கோப்பிற்கு கீழ்க்காணும் பங்களிப்பைச் சேர்த்து, எங்கள் தொகுப்பை நிறுவும் போது உங்கள் செயலி பயன்பாட்டிற்கு உரிய பேதங்களுடன் இணைக்க நாங்கள் உங்களை வழிநடத்துகிறோம். பேதங்கள் உங்கள் install, update, அல்லது dump-autoload ஐ இயக்கிய பிறகு தரவிறக்கப்படும்.

    {
    "post-autoload-dump": ["DefectiveCode\\MJML\\PullBinary::all"]
    }

    MJML பேதம் எங்கள் CDN இத்தொடர்பாகப் பெறப்படும் மற்றும் கின்னின் "bin" கோப்புறையில் சேமிக்கப்படும். உங்கள் உள்ளூர் மற்றும் உற்பத்தி சூழ்நிலைகளுக்கான தேவைப்படுவால் உங்களுக்கு தேவையான பேதங்கள் இறக்குமதி செய்யப்படும்.

    நீங்கள் எங்கள் ஆதரவுடன் குறுகிய அளவுகளை அல்லாத பிற கருத்துக்கள் அல்லது கட்டமைப்பு சூழ்நிலைகளை இணைப்பதற்கான சப்ள் உள்ளடக்கங்கள். கிழ்காணும் பேதங்கள் கிடைக்கும்.

    இயக்க அமைப்பு கட்டமைப்பு கம்போசர் பின் புதுப்பிப்பு கட்டளை
    அனைத்து அனைத்து 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
  2. பின்னர், கீழ்காணும் கம்போசர் கட்டளையை இயக்குவதன் மூலம் PHP தொகுப்பை நிறுவவும்:

    composer require defectivecode/mjml
  3. இது தொடங்கும்! பரிணாமங்களைப் பயன்படுத்தும் போது, எங்கள் தொகுப்பு automaticamente லாரவெலின் தொகுப்பின் கண்டுபிடிப்பைப் பயன்படுத்தும்.

பயன்பாடு (லாரவெல் இல்லாமல்)

நீங்கள் லாரவெல் பயன்படுத்துகிறீர்கள் என்றால் கீழ்காணும் பதிப்பைச் பார்க்கவும்.

MJML ஐ தட்டச்சு செய்வது

MJML ஐ நிலைநாட்ட, உங்கள் MJML வரிசையை render முறைக்கே வழங்குங்கள்:

use DefectiveCode\MJML\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\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\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 தொகுப்பின் அதிகாரபூர்வமான அடிப்பணியைப் பின்பற்றுகிறது, அதே நேரத்தில் கீழ்காணும் விஷயங்களுக்கான பயன்படுத்துபவர்கள்:

எழுத்துருக்கள்

எங்கள் தொகுப்பு அடிப்படையில் கிழ்காணும் எழுத்துருக்களைப் பயன்படுத்துகிறது:

உங்கள் எழுத்துருக்களை மாற்ற, கீழ்காணும் முறைகளைப் பயன்படுத்தலாம்:

கருத்துக்கள்

கருத்துக்கள் இயல்பாக பராமரிக்கப்படுகின்றன. நீங்கள் கருத்துக்களை நீக்க விரும்பினால், 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 ஐ உள்ளடக்கியது, ஆனால் இந்த தொகுப்பு வசதிவாக உள்ளால் மட்டும் நன்மை செம்மைப்படுத்திக்கொள்ளும் என்பதை உள்ளடக்கியது, எனவே தனிப்பயனுருபடு beautifyOptions வேலை செய்கின்றன. இயல்பான விருப்பங்கள்:

js-beautify விஷயங்களை வழங்குவதற்கு இரண்டு உலைப்பட்டிக்குள் snake_case ஐப் பயன்படுத்துகிறது, நீங்கள் எங்கள் தொகுப்பைப் பயன்படுத்தும் போது camelCase ஐப் பயன்படுத்த வேண்டும். இந்த முடிவு எங்கள் தொகுப்பை மற்ற கட்டமைப்புகளுடன் தொடர்புடையதாகவே வைத்திருக்கவேண்டும். எங்கள் தொகுப்பு விலக்குண்டை கட்டமைப்பு பார்வை மதிப்புகளுக்கு வெட்டவிருப்பங்கள்.

இவை உங்கள் அம்சங்களை வழங்குவதன் மூலம் js-beautify அமைப்பு நெருங்கி தொடர்புகள் வழங்கலாம்:

மின் திருத்த

எங்கள் தொகுப்பு அங்கு இயக்கும்போது HTML வெளியீட்டை குறைக்கிறது. குறைக்குதல் பின்வரும் செயல்களைச் செய்கிறது:

நீங்கள் minify(bool $minify) முறையின் மூலம் குறைக்கவேண்டும் அல்லது இல்லை என்பதை உறுதி செய்யலாம்.

ஏன் PHP அடிப்படையிலான மின் திருத்தம்? MJML 5 பழைய பா நாளுநக ஏர் html-minifier ஒன்றும் பயன்படுத்துவதில்லை. எங்கள் தொகுப்பு இன்னும் PHP இல் உள்ள மின் திருத்தத்தை வழங்குகிறது 2.x பதிப்பில் கிடைக்காது. ஆனால், သင် MJML 5 இன் உள்ளடக்கத்தை நடத்துங்கள் htmlnano/cssnano மின் காயமாக்கல் விவரங்களை தெரிவிக்கலாம்.

சரிபார்ப்பு நிலை

எங்கள் தொகுப்பு இயல்பாக soft சரிபார்ப்பு நிலையைப் பயன்படுத்தி MJML ஐ சரிபார்க்கிறது. நீங்கள் validationLevel(ValidationLevel $validationLevel) என்ற முறையைப் பயன்படுத்தி இதைப் மாற்றலாம். கீழ்காணும் சரிபார்ப்பு நிலைகள் கிடைக்கின்றன:

கோப்பு பாதை

எங்கள் தொகுப்பு இயல்பாக . கோப்புத்துறையைப் பயன்படுத்தும். நீங்கள் filePath(string $path) முறையை அழைப்பதன் மூலம் இதைப் மாற்றலாம்.

MJML 5 filePath ஐ உள்ளீட்டுப் பாதுகாப்பு அடிப்படையாகக் கருதுகிறது. உள்ளீடுகள் செயல்படும்போது, filePath இன் வெளியே உள்ள பாதைகள் மறுக்கப்படுகின்றன, உதவிக்குறிவிடும் includePath(string|array|null $path) அனுமதிக்க முடியும்.

ஜூஸ்

எங்களால் எவ்வித juice options ஐ இயல்பாக வழங்கமாட்டோம். உள்ளீடு விருப்பங்களைப் பயன்படுத்தி, கீழ்காணும் முறைகளைப் பயன்படுத்த முடியுமென நான் வருந்துகிறேன்:

ஆதரவு வழிகாட்டிகள்

எங்கள் திறந்த மூல தொகுப்பை தேர்ந்தெடுப்பதற்கு நன்றி! தயவுசெய்து இந்த ஆதரவு வழிகாட்டிகளை ஒரு நிமிடம் பார்ப்பதற்கு அனுக்கூலமாக இருக்கவும். இவை எங்கள் திட்டத்தில் அதிகतम முறையில் உதவுவன.

சமூகம் சிரம இடைமுகம்

எமது திறந்த மூல திட்டம் எமது அற்புதமான சமூகத்தால் ஆதரிக்கப்படுகின்றது. நீங்கள் கேள்விகள் அல்லது உதவிக்கு தேவைப்பட்டால், StackOverflow மற்றும் மற்ற ஆன்லைன் ஆதவாரங்கள் உங்கள் சிறந்த வாய்ப்புகள்.

பிழைகள் மற்றும் அம்ச முன்னுரிமை

ஒரு திறந்த மூல திட்டத்தை நிர்வகிக்கும் உண்மை, ஒவ்வொரு புகாரளிக்கப்பட்ட பிழையும் அல்லது அம்ச கோரிக்கையையும் உடனே தீர்க்க முடியாது. நாம் கேள்விகளை அடுத்தடுத்து தெரிவிக்கும் முறையில் முன்னுரிமை அளிக்கிறோம்:

1. எமது கட்டணம் முறைபடுத்திய தயாரிப்புகளை பாதிக்கும் பிழைகள்

எமது கட்டணம் மூலம் விற்பனை செய்யப்பட்ட தயாரிப்புகளை பாதிக்கும் பிழைகள் எப்போதும் எங்கள் மேற்பார்வை ஆகும். சில சந்தர்பங்களில், நாங்கள் நேரிடையாக எங்களுக்கு பாதிக்கும் பிழைகளை மட்டும் பரிசீலிக்கலாம்.

2. சமூகப் பூல் கோரிக்கைகள்

நீங்கள் ஒரு பிழையை அடையாளம் கண்டு அதை தீர்க்க ஒரு தீர்வு உருவாக்கினால், தயவுசெய்து ஒரு பூல் கோரிக்கையை சமர்ப்பிக்கவும். எமது தயாரிப்புகளை பாதிக்கும் கேள்விகளுக்கு பிறகு, நாங்கள் இந்த சமூக-வழி தீர்வுகளை அடுத்த மேலான முன்னுரிமை அளிக்கிறோம். மதிப்பீடு செய்யப்பட்டு ஒப்புதல் பெற்றவுடன், உங்கள் தீர்வை ஒருங்கிணைப்போம் மற்றும் உங்கள் பங்களிப்புக்கு credits அளிக்கிறோம்.

3. நிதி ஆதரவு

மேற்கொள்ளாத பிரச்சினைகள் வரையறுக்கப்பட்ட வகைகளுக்கு கவனமாக, நீங்கள் அதன் தீர்வுக்கு நிதி உதவியை தேர்வு செய்யலாம். ஒவ்வொரு திறந்த கேள்விக்கும் நீங்கள் நிதி உதவி செய்யலாம். நாங்கள் வழங்கப்பட்ட நிதி அளவூடங்கை அடிப்படையாகக் கொண்டு இந்த பிரச்சினைகளை முன்னுரிமையளிக்கிறோம்.

சமுதாய பங்களிப்புகள்

திறந்த மூல செயல்திறனான பேனையில் அதன் சமுதாயம் செயலில் இருக்க wanneerானபோது வளமாகிறது. நீங்கள் பிழைகளை சரிசெய்யவில்லை எனினும், குறியீட்டு மேம்பாடுகள், ஆவணங்களில் புதுப்பிப்புகள், பயிற்சிகள் அல்லது சமுதாயச் चैनல்களில் மற்றவர்களை ஆதரவளிக்க உதவுவதன் மூலம் பங்களிப்பை சார்ந்துகொள்ள உங்கள் எண்ணங்களை மதியுங்கள். ஐந்தில் நாங்கள் அனைவரையும், சமூகமாக, திறந்த மூல வேலைக்கு அனைத்து அளவிதான் ஆதரிக்கச் சேற்படுத்துகிறோம்.

மீளவேண்டும் என்றால், DefectiveCode எமது கட்டணம் முறையூடான தயாரிப்புகளை பாதிக்கும் பிழைகள், சமூகப் பூல் கோரிக்கைகள் மற்றும் அந்த பிரச்சினைகளுக்கு பெறப்பட்ட நிதி ஆதரவுக்கே முன்பீற்ற அளிக்கும்.

உரிமம் - MIT உரிமம்

காப்புரிமை © Defective Code, LLC. அனைத்து உரிமைகளும் பாதுகாக்கப்பட்டவை

இந்த மென்பொருளுக்கும் அதற்கு உடைய ஆவணக் கோப்புகளுக்கும் (இது "மென்பொருள்") ஒரு நகலைப் பெறும் எந்த நபர்க்கும், கட்டுக்கோப்புகள் இல்லாமல், மென்பொருளில் முகாமை செய்ய அனுமதிக்கப்படுகிறது, இதில் செயல்பாட்டின் உரிமைகள், நகலெடுக்கவும், மாற்றவும், இணைக்கவும், வெளியிடவும், பகிர்வு உரிமம் வழங்கவும் மற்றும்/அல்லது மென்பொருளின் நகல்களை விற்கவும், மற்றும் மென்பொருளின் நகல்களைப் பெறும் நபர்களுக்கு இதைப் செய்ய அனுமதிக்கவும், கீழ்க்காணும் நிலைகளை பின்பற்றுவதற்குப் பண்படுத்தப்படுகிறது:

மேலே குறிப்பிடப்பட்ட காப்புரிமை அறிவிப்பு மற்றும் இந்த அனுமதி அறிவிப்பு அனைத்துப் பிரதிகள் அல்லது முக்கியப் பகுதிகளிலும் உள்ளடக்கப்பட வேண்டும்.

மென்பொருள் "தொலைவிலிருந்து" வழங்கப்படுகிறது, எந்தப் பாலம்ஸ், நடைமுறைகளிலும் ஏதாவது வாக்குறுதி அல்லது குறிப்பிடப்பட்டுள்ளது, ஆனால் வரம்பற்ற வகையில் விற்பனைதிறன், குறிப்பிட்ட ஒரு நோக்கத்திற்கான வசதி மற்றும் உரிமை மீறல் ஆகியவற்றுக்கான வாக்குறுதிகள். எந்த சந்தர்ப்பத்திலும் ஆசிரியர்கள் அல்லது காப்புரிமையாளர்கள் எந்த உரிமையைக் கொண்டாட முடியாது, எந்தக் குற்றத்தை, சேதப்படுத்தல்களை அல்லது பிற பொறுப்புகளை அட/thread-modal/ம், ஒப்பந்தத்தின் ஒரு நடவடிக்கையின்படி, ஆபத்து அல்லது வேறென்னவாக இருந்தாலும், மென்பொருள் அல்லது மென்பொருளைப் பயன்படுத்துவதில் இருந்ததாகவும் உள்ள தேவை/request-modal/ியைக் கொண்டாட முடியாது.