Etykiety

wtorek, 5 grudnia 2017

Wysyłanie wiadomości Email z PowerShell

Bywają sytuację, w których zależy nam na szybkim skorzystaniu z wiersza poleceń, na przykład aby niezawodnie wysłać wiadomość Email z komputera na którym ciężko jest uruchomić cokolwiek innego. Z doświadczenia wiem dobrze, że takie sytuacje zdarzają się nierzadko.

Czy wiedziałeś, że istnieje możliwość wysyłania wiadomości Email z wiersza poleceń PowerShell systemu Windows? Tak. Istnieje taka możliwość, a na dodatek jest to banalnie proste, pod warunkiem oczywiście, że mamy połączenie z internetem. Już wyjaśniam jak to zrobić.

W Windows PowerShell < v 2.0 wysyłanie wiadomości Email było nieco trudniejsze, lecz dziś można się w tym zakresie cieszyć sporym ułatwieniem. Od wersji 2.0 PowerShell'a, do wysyłania wiadomości Email w tym środowisku służy nam cmdlet
Send-MailMessage

Ten cmdlet może być stosowany na kilka różnych sposobów, a oto jego najbardziej popularne parametry:
– Attachments (łańcuch)
Pełna ścieżka i nazwy plików, które mają zostać dołączone do wiadomości e-mail.

–Bcc (łańcuch)
Pole BCC, zawierające adresatów.

–Body
Ciało (treść) wiadomości.

–BodyAsHtml
Tej opcji należy użyć jeśli ciało wiadomości ma zostać wysłane jako HTML.

–Cc (łańcuch)
Pole CC, zawierające adresatów.

–Credential (PSCredential)
Konto, które ma uprawnienia do wysyłania wiadomości e-mail. Domyślnym kontem jest bieżący użytkownik.

–DeliveryNotificationOption Opcja
Powiadomienia o dostarczeniu zostaną wysłane na adres e-mail podany w parametrze -From.

Możliwe opcje DeliveryNotificationOption:

None – Brak Powiadomienia (domyśłnie)
OnSuccess - Powiadom, jeśli dostawa zakończyła się powodzeniem.
OnFailure - Powiadom, jeśli dostawa nie zakończyła się powodzeniem.
Opóźnienie - Powiadom, jeśli dostawa jest opóźniona.
Nigdy - Nigdy nie powiadamiaj.

–Encoding Kodowanie
Kodowanie używane dla ciała i tematu

–From (łańcuch)
Adres Email, z którego wysyłana jest poczta.

–Priority Priorytet
Low, Normal, Hogh

–SmtpServer (łańcuch)
Serwer smtp, stosoway do wysyłania wiadomości

–Subject (łańcuch)
Temat wiadomości

–To (łańcuch)
Adresat - adres email adresata wiadomości

–UseSsl
Zastosuj protokół Secure Sockets Layer (SSL) aby nawiązać połączenie z serwerem SMTP i wysłać wiadomość e-mail. SSL nie jest domyślnie używany.

Nie trzeba tych parametrów dogłębnie studiować. Jak już wspomniałem wcześniej, wysyłanie wiadomości Email z PowerShell jest banalnie proste. Zobaczmy jak to działa na prostym przykładzie. Zauważymy, że w poniższym przykładzie będzie konieczne wprowadzenie poświadczeń dla serwera SMTP w okienku pojawiającym się natychmiast po zatwierdzeniu polecenia:

A oto przykładowy kod cmdleta Send-EmailMesage wraz z przykładowymi wartościami parametrów, które możesz dostosować do własnych potrzeb, aby szybko i efektownie wysyłać wiadomości Email bezpośrednio ze środowiska PowerShell:
$From = "adminexample.com"
$To = "user1@example.com"
$Cc = "user2@example.com"
$Attachment = "C:\temp\file.txt"
$Subject = "Wiadomość testowa"
$Body = "Treść przykładowej wiaodmości"
$SMTPServer = "smtp.example.com"
$SMTPPort = "587"
Send-MailMessage -From $From -to $To -Cc $Cc -Subject $Subject `
-Body $Body -SmtpServer $SMTPServer -port $SMTPPort -UseSsl `
-Credential (Get-Credential) -Attachments $Attachment

Aby przetestować wysyłanie wiadomości Email z poziomu Windows PowerShell skopiuj i wklej powyższy kod do notatnika, dostosuj parametry do własnych potrzeb, skopiuj i wklej całość do okienka PowerShell, a następnie wprowadź poświadczenia konta SMTP. W przypadku wątpliwości lub jakichkolwiek pytań proszę o komentarze!

niedziela, 3 grudnia 2017

Podstępne warunki ubezpieczenia sprzętu elektronicznego

Przy zakupie nowego laptopa bądź innego przenośnego sprzętu elektronicznego spora ilość konsumentów decyduje się na wykupienie specjalnego ubezpieczenia, które zdaniem sprzedawcy miało by pokryć koszty naprawy w "każdym przypadku uszkodzenia".

Sprzedawcy chętnie nakłaniają klientów do "zainwestowania" w ubezpieczenie sprzętu elektronicznego, zapewniając, że daje ono całkowitą ochronę w przypadku zalania, pęknięcia, całkowitego zniszczenia itp. Wydając niemałą sumę pieniędzy na sprzęt elektroniczny, bardzo łatwo jest ulec takim sugestiom i wydać dodatkową kwotę na ubezpieczenie, szczególnie w przypadku gdy sprzedający zapewnia, że zabezpieczy ono konsumenta w przypadku wystąpienia uszkodzeń mechanicznych, które jak wiadomo, są najczęstszą przyczyną odmów naprawy sprzętu w ramach gwarancji. Swoją drogą jakiś czas temu opublikowałem artykuł dotyczący popularnych nieuczciwych praktyk serwisów gwarancyjnych.




Najczęściej ubezpieczenie sprzętu elektronicznego jest nam oferowane w sklepach dużych sieci handlowych, takich jak Saturn czy Media Markt. Prowizja, jaką otrzymują sklepy od towarzystw ubezpieczeniowych za pośrednictwo w takiej sprzedaży polis jest niemała. Sklepy i sprzedawcy bardzo dobrze zarabiają na takich produktach i dlatego zawsze proponują je klientom kupującym drogą elektronikę. Cena takiego ubezpieczenia zależy od jego wariantu, ale jest zawsze wysoka i często może sięgać ponad 25% wartości zakupionego sprzętu.




To jedno wielkie oszustwo


Bardzo niewiele ochrony za bardzo wysoką składkę - tak o ubezpieczeniach sprzętu elektronicznego mówi mec. Aleksander Daszewski z Biura Rzecznika Finansowego.

Z oficjalnego raportu wynika, iż obecnie do Rzecznika Finansowego wpływa średnio ponad 60 skarg miesięcznie w związku z ubezpieczeniami elektroniki zakupionymi w sklepach dużych sieci handlowych. Ale to tylko znikoma ilość przypadków, w świetle ogromnej ilości wprowadzonych w błąd konsumentów, którzy z różnych powodów nie decydują się złożyć skargi, pomimo odmowy odszkodowania ze strony zakładu ubezpieczeń. W rzeczywistości, niemalże w każdym przypadku roszczenia odszkodowania ze strony konsumenta, towarzystwo ubezpieczeniowe znajduje powód by stanowczo odmówić. Wyjątkiem są drobne szkody, w których wystarczy wymiana tanich elementów, takich jak obudowa, głośnik, złącze itp. itp

Ubezpieczenie sprzętu elektronicznego: skargi złożone przez konsumentów
Ubezpieczenie sprzętu elektronicznego: skargi złożone przez konsumentów. Źródło: Rzecznik Finansowy


W świetle oficjalnie złożonych przez konsumentów skarg najgorzej wypadają towarzystwa ubezpieczeniowe Ergo Hestia, Warta, Europa, PZU i Allianz.

Zapoznaj się z treścią OWU


Przed podjęciem decyzji o zakupie ubezpieczenia elektroniki naprawdę warto jest zapoznać się z treścią OWU - Ogólne Warunki Ubezpieczenia. Decydująca dla określenia zakresu odpowiedzialności ubezpieczyciela jest definicja "przypadkowego uszkodzenia", widniejąca w OWU. Odszkodowanie jest przyznawane tylko i wyłącznie w takich przypadkach, a definicja tego typu zdarzenia brzmi następująco:

"Za przypadkowe uszkodzenie uważa się uszkodzenie ubezpieczonego sprzętu wskutek nieszczęśliwego wypadku lub przepięcia prądu"

Według OWU "nieszczęśliwym wypadkiem" jest natomiast:

"Nagłe zdarzenie wywołane przyczyną zewnętrzną, wskutek którego uszkodzeniu uległ ubezpieczony sprzęt, który w chwili tegoż wypadku był użytkowany w sposób zgodny z instrukcją obsługi"

Zastanów się! Komu by się to opłacało?


Nie łudź się, że wykupując polisę ubezpieczeniową sprzętu elektronicznego, zostanie ci przyznane odszkodowanie w każdym przypadku uszkodzenia sprzętu. Zastanów się! Gdyby tak było, towarzystwa ubezpieczeniowe już dawno by zbankrutowały! Nikomu nie opłacało by się takie rozwiązanie i nikt by na tym nie zarobił. Większa część składek opłacanych przez posiadaczy tego typu polis przeznaczona jest na zapłatę prowizji pośredników, czyli sklepów oferujących konsumentom polisę!

Towarzystwa ubezpieczeniowe znajdują różne przyczyny odmowy odszkodowania, a niestety niemal zawsze są one zgodne z prawem. Rzecz w tym, że większość konsumentów - przeważnie ogarnięta zakupowym szałem - w ogóle nie analizuje treści OWU przed podjęciem decyzji o zawarciu umowy.

Bywają dziwne przypadki odmów odszkodowania jak przykładowo uznanie, że 16-miesięczne dziecko „celowo i umyślnie" wrzuciło laptopa do wanny - źródło: Rzecznik Finansowy. Gdy taką argumentację eksperci Rzecznika obalili, ubezpieczyciel próbował odmówić wypłaty, powołując się na to, że zgodnie z instrukcją obsługi laptopa, baterie powinny być przechowywane poza zasięgiem dzieci! Najczęstszą przyczyną odmowy odszkodowania ze strony towarzystw ubezpieczeniowych jest brak opisanego wyżej, tak zwanego czynnika zewnętrznego.

Oto lista przykładowych sytuacji, w których o odszkodowaniu możesz sobie tylko pomarzyć:
  • Popijałeś wodę i niechcący zalałeś laptopa lub telefon
  • Laptop, tablet bądź telefon wypadł ci z rąk i się rozwalił
  • Nadepnąłeś niechcący na laptopa
  • Biegłeś z laptopem, potknąłeś się i rozwaliłeś go całkowicie
  • Twój pies lub kot obsikał ci laptopa, a ten przestał działać
  • Telefon (np. Xperia) trzymałeś w tylnej kieszeni spodni i zgniotłeś go gdy usiadłeś

Czemu w powyższych sytuacjach możesz zapomnieć o odszkodowaniu, nawet jeśli posiadasz drogi wariant polisy? Otóż, zgodnie z definicją nieszczęśliwego wypadku i czynnika zewnętrznego, wylanie wody na laptopa lub inny sprzęt wynika wyłącznie z nieostrożności użytkownika i nie ma tu mowy o jakimkolwiek czynniku zewnętrznym. Upadek laptopa wskutek niepodjęcia właściwych środków ostrożności nie kwalifikuje się jako nieszczęśliwy wypadek, lecz wynika z winy użytkownika. Obsikanie laptopa przez psa też jest wynikiem niezachowania należytych środków ostrożności. Podobne wnioski można wyciągnąć dla pozostałych okoliczności, które widnieją na liście.

Największym problemem jest wprowadzanie konsumentów w błąd, jakoby ubezpieczenie pokrywało koszty zniszczenia sprzętu w każdym przypadku. To jest zupełnie niezgodne z rzeczywistością. Taka sytuacja wynika głównie z nieznajomości OWU ze strony sprzedawców kierujących się głównie motywem prowizyjnym lub ich chęci szybkiego zysku. Prowizje dla sklepów sięgają nawet 70% płaconych przez klienta składek. Bardzo często sprzedawcy są dodatkowo wynagradzani za uzyskany w ten sposób dochód.

Jak uzyskać odszkodowanie


W przypadku odmowy odszkodowania w ramach ubezpieczenia elektroniki należy złożyć pisemną reklamację do towarzystwa ubezpieczeniowego. W przypadku negatywnego rozpatrzenia reklamacji ze strony towarzystwa ubezpieczeniowego warto skontaktować się z Rzecznikiem Finansowym, który w większości przypadków jest w stanie skutecznie pomóc konsumentom.

sobota, 2 grudnia 2017

Laravel od Podstaw: kompozytor widoku

W poprzedniej części szkolenia p.t. Szablony widoków i style CSS nauczyliśmy się pracować ze złożonymi szablonami widoków. Zobaczyliśmy jak uprościć sobie pracę w przypadku widoków złożonych z wielu sekcji, takich jak menu nawigacyjne, boczna kolumna, stopka, zawartość główna. W tej części szkolenia zaprezentuję kolejną ważną ciekawostkę ułatwiającą pracę z widokami, a mowa będzie o Laravel View Composer, czyli o kompozytorze widoków.

Czym jest Laravel View Compser? Otóż wyobraźmy sobie że zawartość naszej szkoleniowej prawej kolumny widoku powinna być dynamiczna. Niech to będzie przykładowo lista najnowszych postów. Załóżmy, że taka lista powinna się wyświetlać w prawej kolumnie w każdym widoku witryny. Pamiętając część szkolenia dotyczącą sposobu przekazywania wartości zmiennych do widoków, teoretycznie moglibyśmy do każdego z widoków, który zawiera prawą boczną kolumnę, przekazać tego typu listę postów, uzyskaną za pomocą przygotowanej w tym celu metody naszej klasy Post. To by zadziałało, ale nie było by to najlepsze rozwiązanie zadania, ponieważ powielanie kodu nie należy do dobrych praktyk programistycznych. W rzeczywistości wyglądało by to paskudnie, gdyby w każdej z funkcji zwracającej widok mielibyśmy się powtarzać:
 public function index() {

   $posts = Post::all();

   $newest = Post::newest(5);

   return view('posts.index', compact('posts', 'newest'));

 }

public function create() {

    $newest = Post::newest(5);

    return view('posts.create', compact('newest'));

}

Na szczęście jest na to lepsze rozwiązanie, a kod powyższych metod można uprościć:
 public function index() {

   $posts = Post::all();

   return view('posts.index', compact('posts'));

 }

public function create() {

    return view('posts.create');

}

Zanim jednak przejdę do najważniejszej części tego tematu, przedstawię metodę Post::newest(), czyli funkcję zwracającą żądaną ilość najnowszych postów. Metoda znajdująca się wewnątrz ciała klasy Post, czyli w pliku app/Post.php wygląda następująco:
 public static function newest($n) {

    return static::latest('created_at')->take($n)->get();

 }

Powyższa funkcja typu static zwraca listę postów uporządkowanych malejąco według ich czasu utworzenia, czyli na samej górze listy znajdują się najnowsze posty. Lista zawiera ostatnie $n postów. W parametrze $n możemy zapodać limit listy postów.

Zakładając, że w miejscu :n wstawimy wartość $n, efekt zastosowanych w naszej funkcji metod Eloquent'a jest taki sam jak w przypadku zapytania SQL:
SELECT * from posts order by created_at desc limit :n

Gdy projektujemy tego typu metodę warto ją sobie przetestować interaktywnie w php artisan tinker. Zobaczmy jak działa metoda Post::newest():



Modyfikujemy szablon widoku prawej kolumny


Aby lista najnowszych postów mogła się prawidłowo wyświetlać w prawej kolumnie widoku, należy odpowiednio dopasować nasz szkoleniowy szablon widoku. Dostosujmy więc omówiony w poprzednim szkoleniu szablon kolumny bocznej do następującego stanu:
<aside class="col-sm-3 ml-sm-auto blog-sidebar">

  <div class="sidebar-module">

        <h4>Najnowsze posty</h4>

        <ol class="list-unstyled">

                @foreach ($newest as $post)

                <li><a href="{{asset('/posty/'.$post->id)}}">{{$post->title}}</a></li>

                @endforeach

        </ol>

  </div>

</aside><!-- /.blog-sidebar -->

Kompozytor widoku


Funkcje kompozytora widoku to wywołania zwrotne lub metody klasy wywoływane podczas renderowania widoku. Jeśli masz dane, które chcesz powiązać z widokiem za każdym razem, gdy widok jest renderowany, kompozytor widoku może pomóc uporządkować tę logikę w jednym miejscu. Aby w naszym szkoleniowym przykładzie wywoływanie metody Post::newest() nie było konieczne z osobna dla każdego widoku w skład którego wchodzi nasza szkoleniowa lista postów, z pomocą przychodzi nam Laravel View Composer. Zobaczmy jak to działa w praktyce! Wewnątrz metody boot() w pliku
app/Providers/AppServiceProvider.php
należy umieścić następującą funkcję, która ma za zadanie przekazać do widoku bocznej kolumny listę najnowszych pięciu postów, uzyskaną poprzez metodę Post::newest():
view()->composer('layouts.aside', function($view) {

    $view->with('newest', Post::newest(5));

 });

Nie zapomnijmy na samej górze pliku, przed deklaracją klasy, umieścić
use App\Post;

Zobaczmy teraz jakie efekty przyniosła nasza praca:

Nasz szkoleniowy widok listy postów
Nasz szkoleniowy widok listy postów


Nasz szkoleniowy widok zawartości posta
Nasz szkoleniowy widok zawartości posta


Nasz szkoleniowy widok tworzenia nowego posta

Nasz szkoleniowy widok tworzenia nowego posta


Podsumowanie


W tej części szkolenia poznaliśmy kompozytor widoku, którego stosowanie ułatwia nam pisanie czystego i niepowielającego się kodu. W kolejnej części szkolenia mam zamiar opisać podstawowe mechanizmy uwierzytelniania w Laravel.