mail2cms User Manual v1.1.0
Contents
1. mail2cms for umbraco 7 version 1 0 for umbraco 7 The email import solution for umbraco let User manual Edition 1 Last updated 03 12 2015 mail2cms user manual O 2015 myHeimarbeit de Prolog mail2cms is the email import solution for umbraco 7 1 With this package you can import emails into cms umbraco This emails can be saved as content nodes and the attachments as media nodes You can import automatically all new emails in a mailbox with a scheduler or you can select single emails per right click context menu and save this mails under the chosen content or media node mail2cms is easy to configure supports a dynamic mapping and most of the default umbraco datatypes mail2cms use the best MIME parser on the market It support IMAP POP3 SSL and is fully compatible with Office 365 Gmail and others This package will create entirely new possibilities in umbraco For example in addition to the basic functionality mail2cms can be used to realize the following things gives marketing agencies and other external service providers the opportunity to integrate images and text directly in Umbraco per mail send an e mail to Umbraco to create and publish a new post in your blog implementa mail reply interface and much more mail2cms user manual 2015 myHeimarbeit de Contents Ee UE CN 1 2 WAS CAML eege eege ge ee Dee H D OUICK El EE 4 A Create e E ll Let EE 6 5 ng EE 8 NS ea AE2. Settings Blacklist amp Whitelist Scheduler G iii Reports Notifications amp log Figure 24 Mapping Dynamic Node names 6 2 6 Document types amp properties Subject key Freely selectable key which is included in the subject line of an e mail To use this function click on Subject key and you will see a new input field In this field you can enter your new key Click on Insert key and this is added in the input field above You can insert unlimited custom subject keys for node names Mapping Mailbox 1 General Nodenames Document types amp properties Media types amp properties Advanced eMail currentNumber subject subjectKey title Subject key Current number Sender Receiver Subject Name of r Attachments attachementNumber subject Subject key Filename Related contentid Attachment number Send e Insert key You can choose which document types to be used to store the emails and in which properties the data is to be stored This function is not available if you have chosen Media in Section see 6 2 1 b This function is the same as we will be described in chapter 6 1 5 Static mapping Document types amp properties 6 2 7 Media types amp properties You can choose which media types to be used to store the attachments and embedded images of emails and in which properties the data is to be stored This function is not ava
3. tree und click on Install local package 3 Choose the file mail2cms_1 0 beta zip You can download this file here todo 4 Click on Load Package e Install package Data Types Only install packages from sources you know and trust Macros When installing an Umbraco package you should use the same caution as when you install an application on your computer amp Packages A malicious package could damage your Umbraco installation just like a malicious application can damage your computer Umbraco package Repository It is recommended to install from the official Umbraco package repository or a custom repository whenever it s passible Created packages EI understand the security risks associated with installing a local package installed packages Install starter kit Choose a file Datei ausw hlen mail2cm eta zip install local package Choose Package from your machine W SST SE Relation Types button and locating the package Ee umb or zip extension XSLT Files Load Package amp Partial View Macro Files Figure 1 Load package 5 Select checkbox for accept license 6 Click on Install package and wait e Install package Data Types Please noto Installing a package containing several items and files can take some time Do not refresh the page or navigate away before the installer notifies you the install amp completed Macros v Packages gt 8 Umbraco p
4. 993 gt Save Receive mails 4 Reload MAILBOXES and open Mapping node under your new created mailbox 5 Go to Section dropdown field and select Content amp Media AI Mailbox 1 mail2umbraco gmail com AI test mail2umbraco gmail com o Settings Blacklist amp Whitelist Scheduler BG iii Reports Figure 6 Mapping Static Select Content amp Media mail2cms user manual Mapping test General Node names General Type Section Content Parent destination node Page 4 of 32 Document types amp properties Advanced Media types amp properties 2015 myHeimarbeit de 6 Goto Document types amp properties tab and choose document type mail2cms_email 7 Assign all properties as shown in the following illustration Al Mailbox 1 mail2umbraco gmail com Settings o Mapping Blacklist amp Whitelist Scheduler Reports Oe G iif Notifications amp log Mapping Mailbox 1 General Document type Choose document type Properties Mapping subject to Mapping text to Mapping sender to Mapping receiver to Mapping CC to Mapping BCC to Mapping list of attachments to Mapping datetime of mail to Figure 7 Mapping Static Document types amp properties Node names Document types amp properties mail2cms_email subject bodyText from attachements importDate Media types amp properties Advanced No mapping bcc 8 Goto M
5. B Notifications amp log info myspam de spam spam de Save Figure 26 Blacklist amp Whitelist mail2cms user manual Page 21 of 32 O 2015 myHeimarbeit de 8 Scheduler The import can be performed automatically at a regular time interval The scheduler uses the default scheduler from umbraco If there is not working please see chapter Troubleshooting You can choose between interval week days and month days Only the selected type will perform the automatically import 8 1 Interval You can enter a time interval in minutes for receiving emails of this mailbox Hint The interval must be a minimum of 5 minutes Scheduler Mailbox 1 Schedule tasks QI Mailbox 1 mail2umbraco gmail com Ss type Constant interval on Settings Mapping Constant interval t Blacklist amp Whitelist Scheduler Interval in minutes 15 Fi Reports B Notifications amp log Figure 27 Scheduler Constant interval 8 2 Week days You can create unlimited schedule tasks for specific recurring weekdays and times for receiving emails of this mailbox Every task must have a title at least one selected day and a specific time In the task overview list below you can activate deactivate and delete the tasks In this overview you see also the last import date for each task mail2cms user manual Page 22 of 32 O 2015 myHeimarbeit de Scheduler Mailbox 1 Schedule tasks Type Week days Title Days Time T
6. 32 2015 myHeimarbeit de Al Mailbox 1 mail2umbraco gmail com Settings o Blacklist amp Whitelist Scheduler G iii Reports DI D Notifications amp log Mapping Mailbox 1 General Node names Document type Choose document type Properties Mapping subject to Mapping text to Mapping sender to Mapping receiver to Mapping CC to Mapping BCC to Mapping list of attachments to Mapping datetime of mail to Figure 18 Mapping Static Document types amp properties 6 1 6 Media types amp properties Document types amp properties Media types amp properties Advanced mail2cms_email E subject y bodyText v from y to v cc v bcc y attachements y importDate v No mapping bcc cc from attachements bodyText subject You can choose which media types to be used to store the attachments and embedded images of emails and in which properties the data is to be stored This function is not available if you have chosen Content in Section see 6 1 1 b The configuration for images and files are the same a Choose Media type file type b Mapping upload image file c Limitations mail2cms user manual Select any existing Media type of your choice for images and for other files Hint If you will use the standard media types of umbraco then select for images the media type Image and for files the media type File You can assign the image file to the
7. Section Media D Media Parent destination node amp Mail attachments Figure 16 Mapping Static Media 6 1 4 Node names Use auto date folders Use unique related W contentid folders Save You can define how the node name to be composed a eMail b Attachments mail2cms user manual Node name for content nodes This field is hidden if you have chosen Media in Section see 6 1 1 b The following terms are available Current number sequential number underneath the parent node Sender email address of sender from Receiver email address of receiver to Subject subject of email Name of mailbox name of mailbox see 4 2 a Email sender date date and time of sending Import date date and time of importing into umbraco Node name for media nodes This field is hidden if you have chosen Content in Section see 6 1 1 b The following terms are available Filename Filename of attachment or embedded image Related contentld works only if you have chosen Page 12 of 32 2015 myHeimarbeit de Content amp Media in Section see 6 1 1 b Attachment number sequential number of attachment in a specific email Sender email address of sender from Receiver email address of receiver to Subject subject of email Name of mailbox name of mailbox see 4 2 a Email sender date date and time of sending Import date date and time of importing into umbraco
8. Seen update status of mail to seen after import Unchanged don t change status of mail after import mail2cms can perform certain actions after importing the imported mails Move imported mails are moved to another folder in your mailbox In the input field Move email into folder you must enter the name of folder Delete imported mails are deleted in mailbox Forward imported mails are forwardet to another emailadsress This emailaddress you can enter in the field Forward email to You can also insert a text for the forwarding mail in input field Text of forwarding email Reply you can enter a text for the reply mail in input field Text of reply email With this action every sender from an imported mail receives automatically an reply email on import Forward amp reply Combination of action Forward and Reply Hint mail2cms use the smtp settings in web config for sending emails Imported emails are saved as eml file in the following folder media mail2cms backup Page 8 of 32 2015 myHeimarbeit de Settings Mailbox 1 Import settings Mailbox 1 mail2umbraco gmail com al 8 Inbox folder Project_Inbox Settings o K Mapping Blacklist amp Whitelist Status to import mails Unseen D fy Scheduler Reports DI D Notifications amp log Actions after import New status of mails Seen D after import Action after import Reply H Text o
9. Static Document types amp properties E 5 Figure 8 Mapping Static Media types amp Droperties nn rnonnn nn rrnnna nr nrnnna nos 5 Figure 9 Create mailbox context MEN ccccccivesccessseaccecivesccccevencceceeadccdssaacceuersacesdevaaccudesaaccudebaaccederaaccusesas 6 Figure 10 Enter mailbox Cred ntidls ccsisssccccrvescccdssanscccssencecsivenccccssesccdds Uanccedsvancevdtvanccdveeancdde a 6 Figure 11 Auto connection CHECK ON SAVE EE 7 Figure 12 Newly created mailbox With subnodes EE 7 FIQUFE Ee e EE 9 Figure e CT 10 e Ueleg LEE 11 FIQUre 16 Mapping Static Media EE 12 Figure 17 Mapping Statie Node NAMES aiii daa dia bdo 13 Figure 18 Mapping Static Document types amp properties ococococommoomenenononononononononononononononenenenenenos 14 Figure 19 Mapping Static Media types amp properties Whitelist BlackliSt ooooconoonnnnonenonmommmmm 15 Figure 20 Mapping Static Media types amp Dropertles nos 15 Figure 21 Mapping Static Advanced USCL scccsssccssssecssscesnecssstecsenseseecssauecsunsusseeesseecsensensnens 16 Figure 22 Mapping Dynamic General Custom UNIQUE Droberty 17 Figure 23 Mapping Dynamic Content 8 Medie 18 Figure 24 Mapping Dynamic Node NAMES ssccccssssccecssssececsenseeecseaececssaeeecssaaeeecseaaeeecssaaeeeessaeeeeseaaes 19 Figure 25 Mapping Dynamic Advanced User c cssccssssecssscesssecesuecssseesnsecesauecsunsusseeessuecseauensanens 2
10. You can activate this section in the user section for every specific user mail2cms user manual Page 30 of 32 2015 myHeimarbeit de 14 EULA Licensee acknowledges that this is a nonexclusive license myHeimarbeit de is the owner of all titles rights and interests in the software Licensee may not sell distribute or package for sale mail2cms Licensee may not decompile reverse engineer or disassemble mail2cms in whole or in part mail2cms includes UI parts of the Umbraco core which is licensed separate under the MIT license mail2cms includes mail dll from limilabs which is licensed separate and is royalty free MAIL2CMS IS DISTRIBUTED AS IS NO WARRANTY OF ANY KIND IS EXPRESSED OR IMPLIED YOU USE THE PROGRAM AT YOUR OWN RISK MYHEIMARBEIT DE DOES NOT WARRANT THAT THE SOFTWARE WILL MEET CUSTOMER S NEEDS OR BE FREE FROM ERRORS OR THAT THE OPERATION OF THE SOFTWARE WILL BE UNINTERRUPTED MYHEIMARBEIT DE WILL NOT BE LIABLE FOR DATA LOSS DAMAGES LOSS OF PROFITS OR ANY OTHER KIND OF LOSS WHILE USING OR MISUSING THIS SOFTWARE mail2cms user manual Page 31 of 32 O 2015 myHeimarbeit de 15 List of figures IQUE bodd DOCK e 2 Figure 22 Install DACKOGC EE 2 Figure 3 Clean mail2cms section after install 5 2205 scsacersaasezerssnssearyedeeaats cacaaescancedars sdeasdhveaenvabstdeadeeyebdetiesss 3 Flgure 4 Createmailboxcontext TEE 4 Figure 5 Enter mailbox ETC 4 Figure 6 Mapping Static Select Content amp Media EE 4 Figure 7 Mapping
11. 0 Figure 26 Blacklist amp Whitelist ees a sisas 21 Figure 27 Scheduler GOnStQNnt INteEVGl ui dd lilas 22 Figure 28 Scheduler Week dOVS 00d tas 23 Figure 29 Scheduler Month e aia 23 Figure S0 ele EE 24 Figure 31 Notifications amp log Notification amp log SettiNgS cooooonononoonnnnanannnnnanannnnnanannnnnannnnnnonnnnos 25 Figure 32 Notifications amp log eMail settings iii id iii 26 Figure 33 Right click Import Content section Context menu 27 Figure 34 Right click Import Content section Import dialogue coocccncnoononnnnonoannnnnananonnnnnannncnnnans 27 Figure 35 Right click Import Media section Context men 28 Figure 36 Right click Import Media section Import CiGlOQue 1 ssscssssessssceessecsessecesseesseessnseesnees 28 mail2cms user manual Page 32 of 32 O 2015 myHeimarbeit de
12. EAEE AEAEE AEREE 8 A ele edu 8 5 1 2 Actions after Import cccccesccccececsssesseaeceecesceeseaeaecececeseeeaaeaeeeseseseeuaeeeeeesseesessaeeeeeesseesegs 8 S E BackUp EE 8 5 2 POP3 Settings 5 2 1 Actions aft r e Lu 9 5 2 2 Bak Psie anean ieoa REESEN 10 5 3 SAVE gl E CTO PPC O 10 ETA o Yodsascsevesdie c saga E E A E EE sagevesbenddees E EEEE 11 6 LStati cmap Pine EE 11 6 11 General CT EE 11 6 1 2 General Contents isa 11 6 13 General Midi ea 12 6 14 NOE naMeS EE 12 6 1 5 Document types amp propertieS ocococccccoconononononononononononononononononononononononononononnnnnnnnnonononononos 13 6 1 6 Media types amp Properties ccc sceserc desse eseu deed ENEE 14 Ged 7 AAVANCEG USER ege E ee eege ee eege E 16 6 2 DINaMICMApPDINS seins 16 6 2 1 General Gordita 16 6 2 2 General Ilres gedeien deeg gedet eegene 16 6 2 3 General CONTENT ica litio 17 6 224 General Media dido 17 EE e te Names rt ii at ted e 19 6 2 6 Document types amp properties nono nnnonnnnnnnnnnonons 19 6 2 7 Mediaitypes 8 properties miii a inid s 19 mail2cms user manual O 2015 myHeimarbeit de 6 2 8 Advanced USEF n r r e aa a nono nnnnan cnc nan cono ra cnn no nnnnanacanana 19 ToBl cklist amp Well a suv ENEE ee Reeg 21 A A O A 22 lU ER RE Mere doe Eden SNE Re eegene oe oe 22 8 3 Month DAYS cei dt cose sees ere td dire ENER suite ENEE ENER seet EEN 23 le EE 24 10 Notificati ns LO ii dts SEENEN ENEE dE ENEE e ies Ree 25 10 1 N
13. Mapping Dynamic General Custom unique property If true it will automatically create year month and day folders under the parent node to store the emails If true the new content nodes for every email will be published after import When using dynamic mapping it is possible that emails are not parsed correctly e g if a content node id is specified in the subject line of an email but which do not exist in umbraco In this case a node must be selected via a Content Picker under which all emails can be stored which can not be parsed correctly Section see 6 2 1 b Freely selectable key which is included in the subject line of an e mail In the example above this is the string files You have two options Mediald This will use the umbraco node id In the example above this is the mediald 6789 Custom unique property You can select any existing property This property must contain an unique value Page 17 of 32 2015 myHeimarbeit de c Use auto date folders If true it will automatically create year month and day folders under the parent node to store the attachments and embedded images of emails d Use unique related contentld folders If true it will automatically create an unique folder for every imported email in media section e Default parent node for parser errors When using dynamic mapping it is possible that emails are not parsed correctly e g if a media node id is specified in the subject
14. Mapping Mailbox 1 General Nodenames Document types amp properties Media types amp properties Advanced eMail currentNumber subject Current number I Sender Receiver Subject Name of mailbox eMail sender date Import Date Attachments attachementNumber subject Filename Related contentid Attachment number Sender Receiver Subject Name of mailbox eMail sender date Import Date Figure 17 Mapping Static Node names 6 1 5 Document types amp properties You can choose which document types to be used to store the emails and in which properties the data is to be stored This function is not available if you have chosen Media in Section see 6 1 1 b a Document type Select any existing document type of your choice Hint mail2cms comes with a default document type mail2cms_email This document type contains properties for all available data of emails b Properties You can assign the most important data of emails to the properties of the selected document type The following data can be assigned subject subject of email text detect automatically html if available otherwise clean text sender email address of sender from receiver email address of receiver to CC copy field of email BCC blind copy field of email attachments only comma separated list of file names datetime date and time of sending mail2cms user manual Page 13 of
15. ackage Repository Name mt Zens Version 1 0 beta gt amp Created packages Author See gt EM installed packages More info http www ma 2ems com install starter kit License MIT License Install local package Accept license Z Accept license ib Relation Types Read me aiaa Wake gt XSLT Files gt Partial View Macro Files Binary files in the package Read more Install Package Figure 2 Install package 7 Now you should see the new mail2cms section in the left bar If not go to user section activate mail2cms section for your user save and press F5 mail2cms user manual Page 2 of 32 O 2015 myHeimarbeit de mail2CMS D First create a mailbox please Figure 3 Clean mail2cms section after install mail2cms user manual Page 3 of 32 2015 myHeimarbeit de 3 Quick start The following are minimum configuration is described to be able to use mail2cms 1 Goto mail2cms section 2 Open the context menu of MAILBOXES and choose Create AI First create a mailbox please Figure 4 Create mailbox context menu Mailboxes create Reload nodes 3 Enter the credentials for your e mail account and the data of the e mail server see chapter 4 2 and click on Save DI First create a mailbox please Figure 5 Enter mailbox credentials Mailbox 1 Credentials Mailbox Name eMail Password Protocol Inbox server Encrypted connection type Port AAP y map gmail com SL X
16. art plugin Reports Imported mails This month Figure 30 Reports mail2cms user manual Page 24 of 32 O 2015 myHeimarbeit de 10 Notifications amp Log mail2cms have its own notification amp log service You can choose which events are write to an own log file and which events trigger an email Per default only parser amp general errors are written to the log file You can find this log file in App_Data Logs mail2cms log txt 10 1 Notifications amp log settings You can activate log amp email triggering for the following mail2cms events General errors Parser errors eMail blacklisting Success import mailbox Success import mail Success import attachments Attachment blacklisting Import details Please use only for debugging import is very slow Actions after import Backup Hint Please use this carefull The number of options you choose has a major influence on the duration of the imports DI Mailbox 1 mail2umbraco gmail com Settings Mapping Blacklist amp Whitelist Scheduler aC ii amp o amp Reports B notifications amp log DI Boxmail 2 mailparser myheimarbeit de QI Test 3 sdemyheimarbeit de Notifications amp log Mailbox 1 Notifications amp Logs eMail settings Notification amp Log Settings Mail notifications General errors Parser errors eMail black listing Success Import mailbox Success Import mail Success Import attac
17. asks Active Y x Y Y Week days if My new thursday import task Monday Tuesday LU Wednesday W Thursday B Friday B Saturday sunday 12 00 Add Task Thu Fri Sat Sun Time Title o o O O 06 00 Mon Wed Mm o O 17 00 weekly friday import o o x EY 09 00 weekend import E A x x 01 00 daily nightly import Figure 28 Scheduler Week days 8 3 Month days You can create unlimited schedule tasks for specific recurring month days and times for receiving emails of this mailbox Last call Every task must have a title a selected month day and a specific time In the task overview list below you can activate deactivate and delete the tasks In this overview you see also the last import date for each task Scheduler Mailbox 1 Schedule tasks Type Month days Title Time Tasks Active x Y x Y last day Time 06 00 17 39 12 00 18 00 Month days M Last month import lastday v 18 00 Add Task Title First import Import 15 Regular import 21 Last month import Figure 29 Scheduler Month days mail2cms user manual Page 23 of 32 Last call 2015 myHeimarbeit de 9 Reports mail2cms comes with a very simple bar chart for visualize the most wanted informations Imported mails Imported amp failed mails Failed imports Failed imports details Scheduled tasks Hint This feature is most likely to be replaced in a future release by another ch
18. chments and embedded images will be saved Media only attachments and embedded images will be saved 6 2 2 General Dynamic a Subject operator Allocation sign for key and value In the example above this is the char in the subject line of an email b Subject separator Separator after key value pair In the example above this is the char in the subject line of an email mail2cms user manual Page 16 of 32 2015 myHeimarbeit de 6 2 3 General Content This is hidden if you have choose Media in Section see 6 2 1 b a Name of key in subject b Key for destination node is related c Use auto date folders d Auto publish e Default parent node for parser errors 6 2 4 General Media This is hidden if you have chosen Content in a Name of key in subject b Key for destination node is related mail2cms user manual Freely selectable key which is included in the subject line of an e mail In the example above this is the string projectid You have two options Nodeld This will use the umbraco node id In the example above this is the nodeld 4567 Custom unique property You can select any existing property This property must contain an unique value Content Name of key in subject projectid for destination node Key for destination Custom unique property node is related to Use auto date folders Es Auto publish D Default parent node for parser errors Add Figure 22
19. d D Se gt Blog SE Chansepocament nee The friendliest Se oat M Contact l Sort S i E el Parser Errors Rollback Se Recycle Bin Audit Trail pol P B Publish B RA Culture and Hostnames a RR Permissions MW z FER Public access gt source Our Umbraco The Friendlies A St ero to Umbraco hero ata Our Umbraco the official communit ai Notifications A ow online training videos for everything Umbraco Whether yo Send To Translation edge to start building answered or looking for cool plugins community is just a click away CH Reload nodes Figure 33 Right click Import Content section Context menu Now you can choose one of your configured mailboxes In next step the newest 20 mails from this mailbox are shown At the end of list you can load the next 20 mails from mailbox If you have your mailbox configured for media amp content section in mapping you can choose a media node to save the attachments You can choose the emails for importing and after that you can click on Import The selected emails are now imported Hint Any configurations are not supported here e g Blacklist amp Whitelist Mail2cms Import A Home m Learn SORT destination node for media m Explore Pare mm extend Em Mall attachments mi Contact Select mails s Parser Errors P Recycle Bin e SE Figure 34 Right click Import Content section Import dialogue mail2cms user manual Page 27 of 32 O 2015 myHeimarbe
20. edia types amp properties tab and choose med type mail2cms_email 9 Assign the media types and properties as shown in the following illustration DI Mailbox 1 mail2umbraco gmail com QI test mail2umbraco gmail com Settings B Mapping 3 Blacklist amp Whitelist Scheduler FA Reports B Notifications amp log Figure 8 Mapping Static Media types amp properties 10 Click on Save Now mail2cms is configured for the first mailbox and can be used with right click context menu in Mapping test General Images Choose media type Mapping upload image to Limitations FilesS Choose file type Mapping upload file to Limitations content and media section see chapter 11 amp 12 mail2cms user manual Page 5 of 32 Node names Document types amp properties mage umbracoFile No limitations File umbracoFile No limitations Media types amp properties Advanced 2015 myHeimarbeit de 4 Create a mailbox In mail2cms you can create an unlimited number of mailboxes You can also create two or more mailboxes in mail2cms for the same email address but with different configurations 1 Open the context menu of MAILBOXES and choose Create Mailboxes Create D First create a mailbox please gt Reload nodes Figure 9 Create mailbox context menu 2 Now you can enter the credentials for your e mail account and the data of the e mail server a Ma
21. f reply email Thank you for your message We will soon get in touch with them Best regard Backup Backup emails Save Figure 13 IMAP settings 5 2 POP3 Settings 5 2 1 Actions after import a Action after import mail2cms can perform certain actions after importing the imported mails Delete imported mails are deleted in mailbox Forward imported mails are forwardet to another emailadsress This emailaddress you can enter in the field Forward email to You can also insert a text for the forwarding mail in input field Text of forwarding email Reply you can enter a text for the reply mail in input field Text of reply email With this action every sender from an imported mail receives automatically an reply email on import Forward amp reply Combination of action Forward and Reply Hint mail2cms use the smtp settings in web config for sending emails mail2cms user manual Page 9 of 32 2015 myHeimarbeit de 5 2 2 Backup a Backup emails Imported emails are saved as eml file in the following folder media mail2cms backup Settings Mailbox 1 Import settings D Mailbox 1 mail2umbraco gmail com Actions after import Settings Sue Action after import Forward amp reply e Mapping 3 Blacklist amp Whitelist X Scheduler Forward email to info myheimarbeit de FA Reports B Notifications amp log Text of forwarding email Forwarded from mail2cms Text of rep
22. file of umbraco Please check if your smtp settings are right Maybe this links can help you http our umbraco org wiki how tos verify that your smtp settings are not preventing you from sending e mail http our umbraco org wiki recommendations recommended reading for net developrs testing smtp http our umbraco org wiki install and setup how to install umbraco on windows server 2008 additional steps for proxy email setup 13 2 Notifications mail from logging is not send see 13 1 Imported emails are not automatically replied to or forwarded 13 3 Scheduler doesn t run or stopped certain times mail2cms use default scheduler of umbraco First check if there is a line like this in umbracoSettings config in lt scheduledTasks gt section lt task log true alias mail2cmsScheduler interval 300 url http localhost 60771 umbraco api mail2cmsApi scheduler gt Please replace localhost 60771 with your own domain name If the app pool is not running neither will the scheduler So for the scheduler to run good you will need to make sure your site is active You can use a ping er for that from another webserver or you can use the windows task planer 13 4 mail2cms can t connect to gmail mailbox mail2cms doesn t support 2 step verification Maybe this will be supported in further versions To use mail2cms with gmail you must deactivate the 2 step verification in your gmail account https support
23. google com accounts answer 1064203 hl en 13 5 The description under the labels in mail2cms is not shown correctly There is a bug in umbraco version 7 1 It is fixed in 7 2 You can fixed it in 7 1 version by yourself First open this file umbraco js umbraco directives js and search for the directive umbControlGroup and change the code to this mail2cms user manual Page 29 of 32 2015 myHeimarbeit de angular module umbraco directives html directive umbControlGroup function localizationService return scope label label description hideLabel alias h require form transclude true restrict E replace true templateUrl views directives html umb control group html link function scope element attr formCtrl scope formValid function if formCtrl return formCtrl Svalid there is no form return true if scope label amp amp scope label 0 scope labelstring localizationService localize scope label substring 1 else scope labelstring scope label if scope description amp amp scope description 0 scope descriptionstring localizationService localize scope description substring 1 else scope descriptionstring scope description You can also sent the umbraco directives js file per email to us info myheimarbeit de and we will fix the bug in this files for you 13 6 mail2cms section is not shown
24. hments Attachment black listing mport details Actions after import Backup Figure 31 Notifications amp log Notification amp log settings mail2cms user manual Page 25 of 32 Log file 2015 myHeimarbeit de 10 2 Email settings The email notifications only works if you have enter in this tab the sender and receiver email address for the notifications Notifications amp log Mailbox 1 Notifications amp Logs eMail settings eMail Settings Mailbox 1 mail2umbraco gmail com H 8 eMail to info myheimarbeit de mo Settings E Mapping Blacklist amp Whitelist eMail from mail2cms myheimarbeit de Y Scheduler Bers B Notifications amp log Al Boxmail 2 mailparser myheimarbeit de Al Test 3 sd myheimarbeit de Figure 32 Notifications amp log eMail settings Hint mail2cms use the smtp settings in web config for sending emails mail2cms user manual Page 26 of 32 O 2015 myHeimarbeit de 11 Content Editor Content section Right click import mail2cms comes with an own right click menu in content section To use this function the mailbox must be configured in mail2cms section and the mapping type must be static Per right click on any node you can choose mail2cms Import directly to save emails under the selected node Blog Create see gions X Delete ndly CMS mail2cms Import W Learn we think this could be the beginning of something beautiful While it may feel c i Explore J Move m exten
25. igure 15 Mapping Static Content mail2cms user manual Content Picker to choose the parent node in content section to save emails If true it will automatically create year month and day folders under the parent node to store the emails If true the new content nodes for every email will be published after import Mapping Mailbox 1 General Nodenames Documenttypes amp properties Media types amp properties Advanced General Type Static v Section Content v Content Parent destination node Blog Use auto date folders 4 Auto publish Ge Page 11 of 32 2015 myHeimarbeit de 6 1 3 General Media This is hidden if you have chosen Content in Section see 6 1 1 b a Parent destination node b Use auto date folders Media Picker to choose the parent node in media section to save attachments and embedded images of emails If true it will automatically create year month and day folders under the parent node to store the attachments and embedded images of emails c Use unique related contentld folders If true it will automatically create an unique folder for AJ Mailbox 1 mail2umbraco gmail com Settings o Mapping Blacklist amp Whitelist G iii By Scheduler Reports DI D Notifications amp log every imported email in media section Mapping Mailbox 1 General Nodenames Document types amp properties Media types amp properties Advanced General Type Static v
26. ilable if you have chosen Content in Section see 6 2 1 b This function is the same as we will be described in chapter 6 1 6 Static mapping Media types amp properties 6 2 8 Advanced User You can select which user should be used to create the content and media nodes Per default the user is used with id 0 a Create by user mail2cms user manual Static Select a specific user for all emails Dynamic Enter your freely selectable key which is included in the subject line of an e mail Page 19 of 32 O 2015 myHeimarbeit de Mapping Mailbox 1 General Nodenames Document types amp properties Media types amp properties Advanced Create by user Dynamic Y user Subject key AI Mailbox 1 mail2umbraco gmail com Settings MB Mapping Figure 25 Mapping Dynamic Advanced User mail2cms user manual Page 20 of 32 O 2015 myHeimarbeit de 7 Blacklist amp Whitelist You can use a simple blacklist or whitelist to determine whether emails are to be imported from certain senders or not First you need to select a list Then you can easily add email addresses and they also remove from the corresponding list Only the selected list will include in the import Blacklist amp Whitelist Mailbox 1 Type Al Mailbox 1 mail2umbraco gmail com zs Select type of list Blacklist Zo Settings E Mapping Blacklist Blacklist amp Whitelist Scheduler mail myspam de Add email to blacklist Ei Reports
27. ilbox name Custom name of your mailbox b eMail Your email dress c Password Password for your email adress d Protocol IMAP or POP3 Hint We recommend to use IMAP because mail2cms with IMAP provides more options e Inbox server Address of your inbox server i e imap gmail com f Encrypted connection type None or SSL g Port Port number of inbox server i e 993 e Mailbox 1 Credentials First create a mailbox please al P Mailbox Name Mailbox 1 eMail mail2cms gmail com Password rre Protocol MAP v Inbox server map gmail com Encrypted connection SSL type Port 993 gt Figure 10 Enter mailbox credentials mail2cms user manual Page 6 of 32 2015 myHeimarbeit de 3 Click on Save and wait mail2cms now tries to connect to the mail server with the entered credentials Port 993 ef A e Check connection Save Receive mails Figure 11 Auto connection check on save 4 The mailbox is saved when the check was successful If everything is going wrong you see another notification and the mailbox aren t saved Hint If you are sure that you have enter the correct credentials but the connection check failed please read the chapter Troubleshooting 5 You must reload the mail2cms tree to see the new mailbox Open the context menu on MAILBOXES and choose Reload nodes Now the new one should be shown A Mailbox 1 Credentials Mailbox 1 mail2umbraco gmail com al E
28. it de 12 Content Editor Media section Right click import mail2cms comes with an own right click menu in media section To use this function the mailbox must be configured in mail2cms section and the mapping type must be static Per right click on any node you can choose mail2cms Import Files directly to save attachments of emails under the selected node Mail Attachments Create t Move Mail attachments E mail2cms Import Files Parser Errors Delete Recycle Bin Sort CH Reload nodes Figure 35 Right click Import Media section Context menu Now you can choose one of your configured mailboxes In next step the newest 20 mails from this mailbox are shown Only emails with attachments will be shown At the end of list you can load the next 20 mails from mailbox You can choose the emails for importing and after that you can click on Import The attachments of selected emails are now imported Hint Any configurations are not supported here e g Blacklist amp Whitelist Mail2cms Import Files Select mailbox Mail attachments Mailbox 1 H Parser Errors Recycle Bin Select mails with attachments E myHeimarbeit de 01 11 2014 01 20 2 Figure 36 Right click Import Media section Import dialogue mail2cms user manual Page 28 of 32 O 2015 myHeimarbeit de 13 Troubleshooting 13 1 Imported emails are not automatically replied to or forwarded mail2cms use default smtp settings in the web config
29. line of an email but which do not exist in umbraco In this case a node must be selected via a Media Picker under which all emails can be stored which can not be parsed correctly Mapping Mailbox 1 General Nodenames Document types amp properties Media types amp properties Advanced General DI Mailbox 1 mail2umbraco gmail com e ype Dynamic S o Settings Mapping Blacklist amp Whitelist Sectors Content amp Media x Scheduler B Reports Dynamic B Notifications amp log Subject operator Subject separator Content Name of key in subject projectid for destination node Key for destination Custom unique property v projectlid v Alias of cy node is related to Use auto date folders 2 Auto publish sg Default parent node for Parser Errors parser errors Media Name of key in subject files for destination node Key for destination Mediald node is related to Use auto date folders Use unique related contentid folders Default parent node for Parser Errors Parser errors Save Figure 23 Mapping Dynamic Content amp Media mail2cms user manual Page 18 of 32 2015 myHeimarbeit de 6 2 5 Node names You can define how the node name to be composed This function is the same as we will be described in chapter 6 1 4 Static mapping Node names In addition there is the following option in dynamic mapping eMail amp Attachments Al Mailbox 1 mail2umbraco gmail com
30. ly email Thank you for your message We will soon get in touch with them Backup Backup emails Gi Save Figure 14 POP3 settings 5 3 Save settings If you will click on Save consider whether the Inbox is reached and saved the settings mail2cms user manual Page 10 of 32 2015 myHeimarbeit de 6 Mapping You can configure here among other things the association of e mail data to content and media and document and media types 6 1 Static mapping This is the simplest way to import emails in umbraco Static means that emails are saved under a static defined content node and the attachments if you activate this option are saved under a static defined media node 6 1 1 General General a Type b Section 6 1 2 General Content Static or Dynamic choose Static to use static mapping Section to save the imported emails Content only meta data and text of email will be saved Attachments or embedded images will not be saved Content amp Media meta data text of email and attachments and embedded images will be saved Media only attachments and embedded images will be saved This is hidden if you have choose Media in Section see 6 1 1 b a Parent destination node b Use auto date folders c Auto publish DI Mailbox 1 mail2umbraco gmail com Settings o Mapping Blacklist amp Whitelist Scheduler Reports ae CG ii Ry Notifications amp log F
31. otifications amp log settings cccccccccccesssssssceeececeseesesseaeeeceesseesesaeseeeesceseeseaaeseeeeseessusnaeaeeeesens 25 TO QE Mall SCCM O ee dE E 26 11 Content Editor Content section Right click jmport 27 12 Content Editor Media section Right click import 28 13 THO UDIESMOOLING enee ce be EE EE sesh duc ds de Ee Ze sence 29 13 1 Imported emails are not automatically replied to or Torwarded 29 13 2 Notifications mail from logging is NOt send 29 13 3 Scheduler doesn t run or stopped Certain mes 29 13 4 mail2cms can t connect to gmail mailboxX cccoconoooononnnnnnonononnnnnnnnnnnnnnononnnnnnnnnnnnnnonnnnnnnnons 29 13 5 The description under the labels in mail2cms is not shown correctly oooooococccncncnonononanncnnnnnnno 29 13 6 mail2cms section is NOt sbown nc nannncnnnn nn nn nn ana i nn rra nn anar an iah 30 VA EULA 2253 ie sok E Goes teanacBeteanedivyobvaeivaaaekdesvassaice s nacht ont sdniventoudeevanedudesencs A sheds 31 15 Det 0 th 40 0 o A re re ee eee ae 32 mail2cms user manual 2015 myHeimarbeit de 1 System requirements mail2cms version 1 0 0 was tested with the following umbraco versions using Microsoft SQL Server 7 1 6 s ZE 7 1 8 hel 7 2 0 7 2 1 7 2 2 mail2cms has not been tested with mySQL now YOU USE THE PROGRAM AT YOUR OWN RISK mail2cms user manual Page 1 of 32 O 2015 myHeimarbeit de 2 Install 1 Go to developer section in umbraco 2 Open Packages
32. properties of the selected document type This property must be an upload field or something similar Hint If you will use the standard media types of umbraco then select for images and files the property umbracoFile None all images files will be imported Whitelist only images files with the file extensions in whitelist will be imported Blacklist images files with the file extensions in blacklist will not be imported Page 14 of 32 O 2015 myHeimarbeit de d Whitelist or Blacklist Al Mailbox 1 mail2umbraco gmail com Settings Mapping Z Blacklist amp Whitelist Y Scheduler Reports Notifications amp log Figure 20 Mapping Static Media types amp properties mail2cms user manual It s just the selected list active You can simple add a file extension to the active list You can also remove any file extension from the list again Images Choose media type Mapping upload image to Limitations Whitelist Figure 19 Mapping Mapping Mailbox 1 General Node names Images Choose media type Mapping upload image to Limitations Blacklist Files Choose file type Mapping upload file to Limitations Page 15 of 32 Document types amp properties mage v umbracoFile H Whitelist v Add image extension to whitelist Static Media types amp properties Whitelist Blacklist Media types amp properties Advanced mage v umbracoFile v Blacklist
33. s Mailbox Name Mailbox 1 o Settings D Mapping SS Betz whitelist eMail mail2umbraco gmail com Scheduler Reports Password ttn ee eee E Notifications amp log Protocol MAP D Inbox server imap gmail com Encrypted connection SSL e type Port 993 Receive mails Success Mailbox 1 mail2umbraco gmail com has been saved Figure 12 Newly created mailbox with subnodes With the Button Receive mails you can receive amp import the emails from your mailbox This works only if the mailbox settings and mapping is configured correctly Information about the minimum configuration you can read in chapter Quick start mail2cms user manual Page 7 of 32 O 2015 myHeimarbeit de 5 Settings The available functions depend on the selected protocol IMAP or POP3 in the mailbox 5 1 IMAP settings 5 1 1 Import settings a Inbox b Status to import emails 5 1 2 Actions after import a New status of mail after import b Action after import 5 1 3 Backup a Backup emails mail2cms user manual Name of mailbox folder Hint if empty mail2cms automatically select the default inbox folder Unseen amp Seen all all mails in mailbox be imported Unseen only mails with status unseen be imported Seen only mails with status seen be imported You can specify whether the status of an e mail to be changed automatically after import Unseen update status of mail to unseen after import
34. v Add image extension to blacklist File v umbracoFile x No limitations v 2015 myHeimarbeit de 6 1 7 Advanced User You can select which user should be used to create the content and media nodes Per default the user is used with id 0 Mapping Mailbox 1 General Nodenames Document types amp properties Media types amp properties Advanced Create by user Static v S ren Deger v Al Mailbox 1 mail2umbraco gmail com Settings f Dlactlict 0 Athitalict Figure 21 Mapping Static Advanced User 6 2 Dynamic mapping With dynamic mapping you have a powerful tool You can define own keys to use in subject of emails to set the parent node dynamically in content and media section of umbraco You can also set the node name variable and set the user to create the nodes in the same way For example With a corresponding configuration of dynamic mapping this subject of an email causes that the email is saved underneath the content node with id 4567 and attachments underneath the media node with id 6789 The create user is user with id 7 Subject Welcome to mail2cms projectld 4567 files 6789 user 7 6 2 1 General General a Type Static or Dynamic choose Dynamic to use dynamic mapping b Section Section to save the imported emails Content only meta data and text of email will be saved Attachments or embedded images will not be saved Content amp Media meta data text of email and atta
Download Pdf Manuals
Related Search